Skip to content
MCP server

ToolRoute

Shortlist the few tools an agent needs for a task from a large tool list

Install
Pricing
Freemium
Platforms
API
Runs
Remotely
Version
0.1.1
Listing updated
2 days ago

About ToolRoute

ToolRoute is a freemium MCP server for ai models and llm tooling. It runs as a hosted remote server, so there is nothing to install locally.

Large tool lists cost tokens on every turn and push models toward picking the wrong one. ToolRoute lets you register a tool set once, then send each task and get back a ranked shortlist of roughly 3 to 12 tools, with confidence, matched terms and the token savings, plus definitions ready to inject in OpenAI, Anthropic, Gemini or MCP format.

Ranking is deterministic BM25 keyword matching, with no LLM or embeddings, taking about a millisecond. The page is frank that it matches words, synonyms and stems rather than meaning, and the shortlist widens when confidence is low. A set can hold up to 500 tools and 600 KB and is kept 90 days after last use. Sets registered from a URL can trigger a drift warning if that server's tools later change.

Two MCP tools, register_tools and route_tools, are served from a remote endpoint. The free tier allows 200 route calls per IP per UTC day. After that, calls cost $0.001 each via x402 payments in USDC or prepaid credits; only HTTP 200 results are charged.

Install

Run in a terminal

claude mcp add --transport http toolroute https://api.youraitools.co/toolroute/mcp

Add to Settings → Connectors → Add custom connector

https://api.youraitools.co/toolroute/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "toolroute": {
      "url": "https://api.youraitools.co/toolroute/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "toolroute": {
      "type": "http",
      "url": "https://api.youraitools.co/toolroute/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "toolroute": {
      "serverUrl": "https://api.youraitools.co/toolroute/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "toolroute": {
      "type": "http",
      "url": "https://api.youraitools.co/toolroute/mcp"
    }
  }
}

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

register_tools
Registers a tool set from a tools array or a public remote MCP URL and returns a set id.
route_tools
Returns a ranked shortlist of tools for a task from a registered set.

What it does

BM25 shortlist
Ranks tools by keyword match, adaptively returning 3 to 12.
Ready-to-inject formats
Returns definitions for OpenAI, Anthropic, Gemini or MCP.
Token savings
Reports how many tool tokens the shortlist saves.
Drift warnings
Flags when a URL-registered server now lists different tools.
Pay per call
Charges $0.001 per route over x402 or by prepaid credits.

Good for

  • Cut tool-definition tokens for an agent with hundreds of tools
  • Pick relevant tools per task before calling a model
  • Detect when an MCP server's tool list has changed
  • Test routing quality on your own tool set

Pricing

Freemium

200 free routes per IP per day; then $0.001 per call via x402 or credits

Prices change. Check api.youraitools.co before you buy.

ToolRoute FAQ

Does it use embeddings or an LLM?

No. It uses deterministic BM25 keyword ranking.

What is free?

200 route_tools calls per IP per UTC day on the remote MCP endpoint, with at most 30 a minute.

What are the size limits?

Up to 500 tools and 600 KB per set; queries up to 500 characters.

Are failed calls charged?

No. Only HTTP 200 results are charged.

Is ToolRoute free?

ToolRoute has a free plan, with paid plans for more usage or features.

How do I add ToolRoute to Claude Code?

Run this command in your terminal: claude mcp add --transport http toolroute https://api.youraitools.co/toolroute/mcp

What are the best alternatives to ToolRoute?

The closest alternatives to ToolRoute are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to ToolRoute

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools