{
  "markdown": "# ToolRouter — the OpenRouter for tools\n\n**The OpenRouter for tools. One MCP connection gives any AI agent 250+ hosted tools, pay per call.**\n\nToolRouter 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.\n\n**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>).\n\n## Connect in one line\n\nHosted 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.\n\n### Claude Code\n\n```bash\nclaude mcp add --transport http toolrouter https://api.toolrouter.com/mcp\n```\n\n### Claude (chat, Desktop, mobile)\n\nCustomize → Connectors → Add custom connector, name it `ToolRouter`, URL `https://api.toolrouter.com/mcp/anthropic`.\n\n### Cursor\n\nAdd to `.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"toolrouter\": {\n      \"url\": \"https://api.toolrouter.com/mcp\"\n    }\n  }\n}\n```\n\n### VS Code\n\nAdd to `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"toolrouter\": {\n      \"type\": \"http\",\n      \"url\": \"https://api.toolrouter.com/mcp\"\n    }\n  }\n}\n```\n\n### Gemini CLI\n\nAdd to `~/.gemini/settings.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"toolrouter\": {\n      \"httpUrl\": \"https://api.toolrouter.com/mcp\"\n    }\n  }\n}\n```\n\n### Windsurf\n\nAdd to `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"toolrouter\": {\n      \"serverUrl\": \"https://api.toolrouter.com/mcp\"\n    }\n  }\n}\n```\n\nAny other MCP client that speaks streamable HTTP can use the same URL.\n\n## Local bridge (npm)\n\n`toolrouter-mcp` is a stdio bridge to the same hosted gateway, plus a CLI. Use it where a client cannot take a remote URL.\n\n## Three ways to use it\n\n### 1. MCP Server (for AI agents)\n\nRun with no arguments to start an MCP stdio server. No API key needed — auto-provisions on first use:\n\n```bash\nnpx -y toolrouter-mcp\n```\n\n### 2. CLI (for terminal workflows)\n\n```bash\nnpx -y toolrouter-mcp tools                    # list all tools\nnpx -y toolrouter-mcp search \"web scraping\"    # search by keyword\nnpx -y toolrouter-mcp call seo analyze_page --url https://example.com\nnpx -y toolrouter-mcp help\n```\n\n### 3. REST API (direct HTTP)\n\n```bash\n# Get an API key (or use one from ~/.toolrouter/key after MCP setup)\ncurl -X POST https://api.toolrouter.com/v1/auth/provision\n\ncurl -H \"Authorization: Bearer $TOOLROUTER_API_KEY\" \\\n  -d '{\"tool\":\"seo\",\"skill\":\"analyze_page\",\"input\":{\"url\":\"https://example.com\"}}' \\\n  https://api.toolrouter.com/v1/tools/call\n```\n\n## Install the local bridge\n\n### Codex CLI\n\n```bash\ncodex mcp add toolrouter -- npx -y toolrouter-mcp\n```\n\n### Cursor\n\nAdd to `.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"toolrouter\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"toolrouter-mcp\"]\n    }\n  }\n}\n```\n\n### Windsurf\n\nAdd to `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"toolrouter\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"toolrouter-mcp\"]\n    }\n  }\n}\n```\n\n### OpenClaw\n\nAdd to `openclaw.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"toolrouter\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"toolrouter-mcp\"]\n    }\n  }\n}\n```\n\n### Cline\n\nOpen MCP settings and add:\n\n```json\n{\n  \"mcpServers\": {\n    \"toolrouter\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"toolrouter-mcp\"]\n    }\n  }\n}\n```\n\n### VS Code\n\nAdd to `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"toolrouter\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"toolrouter-mcp\"]\n    }\n  }\n}\n```\n\n### Gemini CLI\n\nAdd to your Gemini CLI settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"toolrouter\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"toolrouter-mcp\"]\n    }\n  }\n}\n```\n\n### Claude Desktop\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"toolrouter\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"toolrouter-mcp\"]\n    }\n  }\n}\n```\n\n## API Key\n\nNo 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.\n\nTo use an existing key instead: set `TOOLROUTER_API_KEY=tr_live_xxx` as an environment variable.\n\n## How It Works\n\nThis package serves two purposes from one binary:\n\n- **MCP mode** (no args): Starts an MCP stdio server that proxies `tools/list` and `tools/call` to the ToolRouter API via Streamable HTTP.\n- **CLI mode** (`tools`/`search`/`call`/`help`): Thin HTTP client that sends requests to the ToolRouter API and prints results. No local tool execution.\n\nBoth modes go through `https://api.toolrouter.com` — all processing happens on ToolRouter's infrastructure.\n\n## MCP Meta-Tools\n\nWhen connected via MCP, your agent gets meta-tools for tool discovery, execution, async jobs, and full account management:\n\n**Discovery & execution:**\n\n| Tool | Description |\n|------|-------------|\n| `discover` | Find tools by keyword, category, or `*` for all |\n| `use_tool` | Execute a tool skill |\n| `job_get` | Poll an async job's status and result |\n| `job_list` | List recent async jobs |\n| `job_cancel` | Cancel a running async job |\n\n**Credits & billing:**\n\n| Tool | Description |\n|------|-------------|\n| `credits_balance` | Get available credit balance |\n| `credits_usage` | Usage breakdown and recent call history |\n| `top_up_credits` | Add credits |\n| `subscription_manage` | View or change your subscription |\n| `invoice_list` | List invoices |\n\n**API keys:**\n\n| Tool | Description |\n|------|-------------|\n| `key_create` | Create a new API key |\n| `key_list` | List API keys |\n| `key_delete` | Permanently disable an API key |\n\n**Credentials (BYOK):**\n\n| Tool | Description |\n|------|-------------|\n| `credential_save` | Save your own provider API key |\n| `credential_list` | List saved credentials |\n| `credential_delete` | Remove a saved credential |\n| `credential_default` | Set the default credential for a provider |\n\n**Connectors & account:**\n\n| Tool | Description |\n|------|-------------|\n| `connector_add` | Connect a SaaS account via OAuth |\n| `connector_list` | List connected accounts |\n| `account_preferences` | View and update account settings |\n| `feedback_review` | Rate a tool |\n\n## Environment Variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `TOOLROUTER_API_KEY` | Yes (for tool calls) | — | Your API key |\n| `TOOLROUTER_API_URL` | No | `https://api.toolrouter.com` | Custom API endpoint |\n\n## CLI Reference\n\n| Command | Auth Required | Description |\n|---------|---------------|-------------|\n| `tools` | No | List all available tools |\n| `search <query>` | No | Search tools by keyword |\n| `call <tool> <skill> [opts]` | Yes | Call a tool skill |\n| `help` | No | Show usage help |\n\n### Input methods for `call`\n\n```bash\n# Flag-based (most common)\nnpx -y toolrouter-mcp call humanleap/seo analyze_page --url https://example.com\n\n# JSON string\nnpx -y toolrouter-mcp call humanleap/web-search search --input '{\"query\":\"MCP tools\"}'\n```\n\n## Requirements\n\n- Node.js 22+\n\n## Links\n\n- [Website](https://toolrouter.com)\n- [Connect / Setup Guide](https://toolrouter.com/connect)\n- [Browse Tools](https://toolrouter.com/tools)\n- [Documentation](https://toolrouter.com/docs)\n- [REST API](https://api.toolrouter.com/v1/tools)\n- [Privacy Policy](https://toolrouter.com/privacy)\n- [Terms](https://toolrouter.com/terms)\n\n## Privacy Policy\n\nhttps://toolrouter.com/privacy\n\n## Support\n\nsupport@toolrouter.com\n",
  "bytes": 7891,
  "sha": "6e3bee44dccf77853b5b4f5530a0d220b079e5b9f2ff95193a7550770bf8f855",
  "repo_slug": "humanleap/toolrouter-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_humanleap_toolrouter_e1527275/readme"
}