toolrouter-gateway

# ToolRouter Gateway One skill to rule them all. ToolRouter provides 150+ tools (competitor research, vulnerability scanning, video generation, web scraping, etc.). This skill makes them feel like native OpenClaw tools. ## How It Works 1. **Discovery** — Fetches ToolRouter's tool catalog (cached 24h) 2. **Dynamic Tools** — Each ToolRouter tool becomes `toolrouter_<slug>` in your registry 3. **Proxy** — All calls go to `https://api.toolrouter.com/mcp` with your API key 4. **Caching** — Responses cached by input hash (TTL configurable) 5. **Usage Tracking** — Counts calls per tool, shows in status ## Prerequisites - ToolRouter API key (get at https://toolrouter.com — auto-provisioned on first use) - Set environment variable: `TOOLROUTER_API_KEY=your_key` ## Tools ### toolrouter_discovery Search the catalog: ```json { "query": "competitor", "category": "research", "limit": 10 } ``` Returns list of available tools with: - `slug` — use in tool name (`toolrouter_<slug>`) - `name`, `description` - `input_schema` — JSONSchema for the tool - `category`, `pricing` (cost per call) ### toolrouter_status ```json {} ``` Returns: ```json { "api_connected": true, "cache_age_minutes": 12, "total_calls": 147, "calls_today": 23, "enabled_tools": 42, "errors_last_24h": 0 } ``` ### Dynamic Tools (examples) Once catalog is fetched, you can call any ToolRouter tool: ```python # Competitor research tool("toolrouter-gateway", "toolrouter_competitor_research", { "url": "https://example.com", "depth": "full" }) # Vulnerability scan tool("toolrouter-gateway", "toolrouter_security_scan", { "target": "https://myapp.com", "checks": ["cve", "misconfig"] }) # Video generation tool("toolrouter-gateway", "toolrouter_video_from_brief", { "brief": "30s product demo for OpenClaw Memory Stack", "style": "modern" }) ``` Tool names are derived from ToolRouter slugs (replace hyphens with underscores, add `toolrouter_` prefix). The `toolrouter_discovery` tool tells you which slugs exist. ## Configuration Optional `toolrouter-gateway-config.json`: ```json { "api_url": "https://api.toolrouter.com/mcp", "cache_ttl_minutes": 1440, "usage_log_file": "memory/toolrouter-usage.jsonl", "enable_caching": true, "timeout_seconds": 60 } ``` ## Caching - Cache key: SHA256 of tool name + input JSON - Stored in `memory/toolrouter-cache.jsonl` - Reduces cost and improves speed for repeated calls - Can be cleared manually if needed ## Usage Tracking All calls logged to `memory/toolrouter-usage.jsonl`: ```json {"timestamp":"2026-04-01T17:40:00Z","tool":"competitor_research","input_hash":"abc123","cost":0.005} ``` `toolrouter_status` aggregates these. ## Error Handling - API down → returns cached response if available, else error - Rate limits → exponential backoff retry (3 attempts) - Invalid tool → `discovery` tool will reflect removal from catalog ## MCP Integration The gateway can also run as an MCP server (experimental): ```bash # Start MCP server (stdio) toolrouter-gateway --mcp ``` Other MCP clients can then connect and use all ToolRouter tools as MCP resources. ## Pricing $49/month. Includes: - Unlimited tool calls (you pay ToolRouter usage separately; most tools cost fractions of a cent) - Caching reduces your ToolRouter bill - Usage analytics - Priority support You need your own ToolRouter API key (free tier available). ## FAQ **Q: Do I pay per ToolRouter call?** A: Yes, ToolRouter charges per call (typically $0.001–$0.05). Our caching minimizes costs. **Q: Can I add my own tools to ToolRouter?** A: ToolRouter is a separate service; contact them for custom integrations. **Q: What if a tool is flaky?** A: Check `toolrouter_status` for error rates. Cache helps smooth failures. **Q: Is there a free trial?** A: Not yet. But ToolRouter has a free tier with limited calls. --- *Inspired by ClawHub's toolrouter skill, extended with caching, usage tracking, and native tool manifests.*