ptc-orchestration - Claude MCP Skill

# 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
```bash
# 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
```python
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:
```bash
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`