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.