salverius-tech/ptc-orchestration

PTC Orchestration Skill

Use Programmatic Tool Calling (PTC) for efficient multi-tool workflows. PTC allows Claude to write Python code that orchestrates multiple tool calls, reducing:

• API round-trips (60% fewer calls)
• Context token usage (65% reduction)
• Execution time (53% faster)

When to Use

Activate this skill when the user needs:

• Multi-URL scraping: Fetch and compare multiple web pages
• Browser automation: Chain multiple browser actions (navigate → snapshot → click → extract)
• Tool orchestration: Any workflow with 3+ sequential tool calls

Available Commands

CLI Usage

# Multi-URL scraping with summarization
python -m ptc_wrapper.cli scrape https://url1.com https://url2.com

# Browser automation pipeline
python -m ptc_wrapper.cli browser "Navigate to X, extract Y" --url https://start.com

# Custom PTC prompt
python -m ptc_wrapper.cli run "Your complex multi-tool task" --servers flaresolverr,browsermcp

# List available tools
python -m ptc_wrapper.cli list --tools

Python API

from ptc_wrapper import PTCClient

async with PTCClient() as client:
    await client.load_mcp_servers(["flaresolverr"])
    result = await client.scrape_urls(urls, summarize=True)

Setup

Ensure the wrapper is installed:

cd ~/.claude/tools/ptc-wrapper
uv pip install -e .

Key Features

1. MCP Integration: Works with existing MCP servers (flaresolverr, browsermcp)
2. Tool Search: Uses allowed_callers to enable code execution
3. Input Examples: Auto-generates examples for better parameter accuracy
4. Agentic Loop: Handles multi-turn tool execution automatically

Architecture

PTCClient → Anthropic API (with code_execution)
    ↓
MCPClient → MCP Servers (flaresolverr, browsermcp via stdio)

The wrapper adds:

• code_execution_20250825 tool to enable PTC
• allowed_callers: ["code_execution_20250825"] to each tool
• input_examples for parameter accuracy
• Beta header: advanced-tool-use-2025-11-20