# ToolRoute

> ToolRoute is a freemium MCP server for ai models and llm tooling. Shortlist the few tools an agent needs for a task from a large tool list. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API
- **Website:** https://api.youraitools.co/toolroute/
- **MCP Registry name:** co.youraitools/toolroute
- **Categories:** AI models and LLM tooling, developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.youraitools.co/toolroute/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "toolroute": {
      "url": "https://api.youraitools.co/toolroute/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/toolroute
