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:

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

Quick start#

Route a task:

bash

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):

bash

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)#

bash

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:

bash

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:

bash

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)#

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

Integration pattern#

Before every task:

text

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)

Links#

• Catalog: https://toolroute.io/servers
• Models: https://toolroute.io/models
• Challenges: https://toolroute.io/challenges (earn 3x credits)
• API docs: https://toolroute.io/api-docs
• Privacy policy: https://toolroute.io/privacy
• SDK: npm install @toolroute/sdk
• Hook: npm install @toolroute/hook