toolrouter-mcp

MCP server + CLI for ToolRouter. One package, every tool — discover, search, and call AI tools from any agent or terminal.

ToolRouter gives AI agents access to 15+ tools and 49+ skills (SEO, screenshots, image generation, web scraping, security scanning, and more) through a single integration with usage-based billing. Everything runs on the hosted gateway — nothing executes locally.

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 as MCP Server

Claude Code

claude mcp add toolrouter -- npx -y toolrouter-mcp

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 18 meta-tools covering tool discovery, execution, and full account management:

Tool discovery & execution:

| Tool | Description | |------|-------------| | discover | Find tools by keyword, category, or * for all | | use_tool | Execute a tool skill | | get_job_result | Poll async job status | | cancel_job | Cancel a running async job |

Account & billing:

| Tool | Description | |------|-------------| | check_balance | Get available credit balance | | top_up_credits | Generate Stripe checkout link to add credits | | billing_portal | Get Stripe portal link for payment methods | | get_billing_preferences | View auto-reload and budget settings | | set_billing_preferences | Update auto-reload and budget settings |

API key management:

| Tool | Description | |------|-------------| | list_api_keys | List all API keys | | create_api_key | Create a new API key | | revoke_api_key | Permanently disable an API key |

Credentials (BYOK):

| Tool | Description | |------|-------------| | save_credential | Save your own provider API key | | list_credentials | List saved credentials | | delete_credential | Remove a saved credential |

Usage & feedback:

| Tool | Description | |------|-------------| | get_usage_summary | Usage breakdown by tool | | get_usage_history | Recent call history with costs | | submit_review | Rate a tool 1-5 stars |

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+

Links

• Website
• Connect / Setup Guide
• Browse Tools
• Documentation
• REST API