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