toolrouter-mcp

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

ToolRouter gives your AI agent one connection to 226 tools and 1,208 skills — web search, image and video generation, SEO and GEO, web scraping, lead finding, competitor research, document analysis, security scanning, and much more — across Claude, ChatGPT, Cursor, Windsurf, Codex, Gemini CLI, VS Code, Cline, and OpenClaw. Everything runs on the hosted gateway; nothing executes locally.

# Claude Code — one line, no API key needed (auto-provisions on first use)
claude mcp add toolrouter -- npx -y toolrouter-mcp

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

Related MCP server: mcp-services

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 meta-tools for tool discovery, execution, async jobs, and full account management:

Discovery & execution:

Credits & billing:

API keys:

Credentials (BYOK):

Connectors & account:

Environment Variables

CLI Reference

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