ToolRouter

The OpenRouter for tools. One MCP connection gives any AI agent 250+ hosted tools, pay per call.

Documentation

ToolRouter — the OpenRouter for tools

The OpenRouter for tools. One MCP connection gives any AI agent 250+ hosted tools, pay per call.

ToolRouter is the OpenRouter for tools. Connect once over MCP and your agent can discover and call 250+ hosted specialist tools: web search, scraping, image and video generation, SEO, finance, property, compliance and more. Free tools work immediately; paid tools are pay per call. Everything runs on the hosted gateway; nothing executes locally.

The compact routing surface costs an agent about 9,000 tokens of context for the whole catalog, versus roughly 257,000 tokens if every skill were loaded as its own tool (measured 2026-09-03; method and raw data at https://toolrouter.com/blog/mcp-tool-schema-token-cost).

Connect in one line

Hosted endpoint: https://api.toolrouter.com/mcp (streamable HTTP). No API key needed — the server provisions a free account on first connect and returns a claim link.

Claude Code

claude mcp add --transport http toolrouter https://api.toolrouter.com/mcp

Claude (chat, Desktop, mobile)

Customize → Connectors → Add custom connector, name it ToolRouter, URL https://api.toolrouter.com/mcp/anthropic.

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "toolrouter": {
      "url": "https://api.toolrouter.com/mcp"
    }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "toolrouter": {
      "type": "http",
      "url": "https://api.toolrouter.com/mcp"
    }
  }
}

Gemini CLI

Add to ~/.gemini/settings.json:

{
  "mcpServers": {
    "toolrouter": {
      "httpUrl": "https://api.toolrouter.com/mcp"
    }
  }
}

Windsurf

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

{
  "mcpServers": {
    "toolrouter": {
      "serverUrl": "https://api.toolrouter.com/mcp"
    }
  }
}

Any other MCP client that speaks streamable HTTP can use the same URL.

Local bridge (npm)

toolrouter-mcp is a stdio bridge to the same hosted gateway, plus a CLI. Use it where a client cannot take a remote URL.

Three ways to use it

1. MCP Server (for AI agents)

Run with no arguments to start an MCP stdio server. No API key needed — auto-provisions on first use:

npx -y toolrouter-mcp

2. CLI (for terminal workflows)

npx -y toolrouter-mcp tools                    # list all tools
npx -y toolrouter-mcp search "web scraping"    # search by keyword
npx -y toolrouter-mcp call seo analyze_page --url https://example.com
npx -y toolrouter-mcp help

3. REST API (direct HTTP)

# Get an API key (or use one from ~/.toolrouter/key after MCP setup)
curl -X POST https://api.toolrouter.com/v1/auth/provision

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{"tool":"seo","skill":"analyze_page","input":{"url":"https://example.com"}}' \
  https://api.toolrouter.com/v1/tools/call

Install the local bridge

Codex CLI

codex mcp add toolrouter -- npx -y toolrouter-mcp

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "toolrouter": {
      "command": "npx",
      "args": ["-y", "toolrouter-mcp"]
    }
  }
}

Windsurf

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

{
  "mcpServers": {
    "toolrouter": {
      "command": "npx",
      "args": ["-y", "toolrouter-mcp"]
    }
  }
}

OpenClaw

Add to openclaw.json:

{
  "mcpServers": {
    "toolrouter": {
      "command": "npx",
      "args": ["-y", "toolrouter-mcp"]
    }
  }
}

Cline

Open MCP settings and add:

{
  "mcpServers": {
    "toolrouter": {
      "command": "npx",
      "args": ["-y", "toolrouter-mcp"]
    }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "toolrouter": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "toolrouter-mcp"]
    }
  }
}

Gemini CLI

Add to your Gemini CLI settings:

{
  "mcpServers": {
    "toolrouter": {
      "command": "npx",
      "args": ["-y", "toolrouter-mcp"]
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "toolrouter": {
      "command": "npx",
      "args": ["-y", "toolrouter-mcp"]
    }
  }
}

API Key

No setup needed — toolrouter-mcp auto-provisions a free API key on first use and caches it to ~/.toolrouter/key. Free tools work immediately. For paid tools, visit the claim URL printed on first run to add credits.

To use an existing key instead: set TOOLROUTER_API_KEY=tr_live_xxx as an environment variable.

How It Works

This package serves two purposes from one binary:

MCP mode (no args): Starts an MCP stdio server that proxies tools/list and tools/call to the ToolRouter API via Streamable HTTP.
CLI mode (tools/search/call/help): Thin HTTP client that sends requests to the ToolRouter API and prints results. No local tool execution.

Both modes go through https://api.toolrouter.com — all processing happens on ToolRouter's infrastructure.

MCP Meta-Tools

When connected via MCP, your agent gets meta-tools for tool discovery, execution, async jobs, and full account management:

Discovery & execution:

Tool	Description
`discover`	Find tools by keyword, category, or `*` for all
`use_tool`	Execute a tool skill
`job_get`	Poll an async job's status and result
`job_list`	List recent async jobs
`job_cancel`	Cancel a running async job

Credits & billing:

Tool	Description
`credits_balance`	Get available credit balance
`credits_usage`	Usage breakdown and recent call history
`top_up_credits`	Add credits
`subscription_manage`	View or change your subscription
`invoice_list`	List invoices

API keys:

Tool	Description
`key_create`	Create a new API key
`key_list`	List API keys
`key_delete`	Permanently disable an API key

Credentials (BYOK):

Tool	Description
`credential_save`	Save your own provider API key
`credential_list`	List saved credentials
`credential_delete`	Remove a saved credential
`credential_default`	Set the default credential for a provider

Connectors & account:

Tool	Description
`connector_add`	Connect a SaaS account via OAuth
`connector_list`	List connected accounts
`account_preferences`	View and update account settings
`feedback_review`	Rate a tool

Environment Variables

Variable	Required	Default	Description
`TOOLROUTER_API_KEY`	Yes (for tool calls)	—	Your API key
`TOOLROUTER_API_URL`	No	`https://api.toolrouter.com`	Custom API endpoint

CLI Reference

Command	Auth Required	Description
`tools`	No	List all available tools
`search <query>`	No	Search tools by keyword
`call <tool> <skill> [opts]`	Yes	Call a tool skill
`help`	No	Show usage help

Input methods for `call`

# Flag-based (most common)
npx -y toolrouter-mcp call humanleap/seo analyze_page --url https://example.com

# JSON string
npx -y toolrouter-mcp call humanleap/web-search search --input '{"query":"MCP tools"}'

Requirements

Node.js 22+

Privacy Policy

https://toolrouter.com/privacy

Support

support@toolrouter.com

ToolRouter

Documentation

ToolRouter — the OpenRouter for tools

Connect in one line

Claude Code

Claude (chat, Desktop, mobile)

Cursor

VS Code

Gemini CLI

Windsurf

Local bridge (npm)

Three ways to use it

1. MCP Server (for AI agents)

2. CLI (for terminal workflows)

3. REST API (direct HTTP)

Install the local bridge

Codex CLI

Cursor

Windsurf

OpenClaw

Cline

VS Code

Gemini CLI

Claude Desktop

API Key

How It Works

MCP Meta-Tools

Environment Variables

CLI Reference

Input methods for call

Requirements

Links

Privacy Policy

Support

Input methods for `call`