ToolRoute

MCP Tools

Route every task to the best MCP server and cheapest LLM. Scores on real execution data across quality, reliability, speed, cost, and trust.

Install

openclaw skills install toolroute

ToolRoute - Intelligent Task Routing

Before every task, ask ToolRoute which MCP server and LLM model to use. It recommends based on real execution data scored across 5 dimensions.

Privacy and Data Handling

What is sent: A natural language task description (e.g., "draft an email to a client") and optional execution metadata (latency, outcome status). No file contents, credentials, API keys, or personal data are sent.

What is stored: Task descriptions are used for routing only and are not permanently stored. Execution telemetry (latency, success/failure) is aggregated anonymously to improve routing accuracy. See https://toolroute.io/privacy for the full policy.

Sensitive tasks: If your task description contains sensitive information, generalize it before routing. Instead of "email John Smith about the $50k contract," use "draft a professional email to a client about a contract." The routing engine only needs the task type, not the details.

Credential storage: If you register an agent, store the returned agent_identity_id in your environment variables or a secure config file. Do not hardcode it in shared scripts.

What this skill does

When activated, this skill:

Routes your current task through https://toolroute.io/api/route
Returns the best MCP server, model, and fallback chain
After execution, optionally reports the outcome to improve future routing

Quick start

Route a task:

curl -s -X POST https://toolroute.io/api/route \
  -H "Content-Type: application/json" \
  -d '{"task": "YOUR_TASK_DESCRIPTION"}'

Report the outcome (optional, earns routing credits):

curl -s -X POST https://toolroute.io/api/report \
  -H "Content-Type: application/json" \
  -d '{"skill_slug": "SKILL_USED", "outcome_status": "success", "latency_ms": 1200}'

Registration (optional, earns 2x credits)

curl -s -X POST https://toolroute.io/api/agents/register \
  -H "Content-Type: application/json" \
  -d '{"agent_name": "YOUR_AGENT_NAME"}'

Store the returned agent_identity_id in an environment variable:

export TOOLROUTE_AGENT_ID="your-returned-id"

Include it in future route/report calls for credit tracking.

Model routing

Get the best model for your task at the lowest cost:

curl -s -X POST https://toolroute.io/api/route/model \
  -H "Content-Type: application/json" \
  -d '{"task": "YOUR_TASK_DESCRIPTION"}'

Verification (earns permanent 2x credits)

Call POST /api/verify/initiate with your agent name
Send the returned claim URL to your human owner
They tweet and verify - you earn 2x credits forever

Integration pattern

Before every task:

1. Describe your task in natural language (generalize sensitive details)
2. POST to /api/route - get recommended skill + model
3. Execute using the recommended tool
4. POST to /api/report - earn credits, improve routing (optional)