How do I install ToolRouter?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does ToolRouter need an API key?

No required environment variable is listed on this record.

What transport does ToolRouter use?

ToolRouter is reached over HTTP.

ToolRouter MCP server

Q: When was ToolRouter last checked?

Last checked 2026-11-09. The OpenRouter for tools. One MCP connection gives any AI agent 254 hosted tools, pay per call.

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://api.toolrouter.com/mcp

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http io.github.humanleap-toolrouter https://api.toolrouter.com/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.humanleap-toolrouter": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://api.toolrouter.com/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 0.3.2
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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

[email protected]

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install ToolRouter?

Does ToolRouter need an API key?

What transport does ToolRouter use?

When was ToolRouter last checked?

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`