ToolRouter
O OpenRouter para ferramentas. Uma única conexão MCP dá a qualquer agente de IA mais de 250 ferramentas hospedadas, pagamento por chamada.
Documentação
ToolRouter — o OpenRouter para ferramentas
O OpenRouter para ferramentas. Uma conexão MCP dá a qualquer agente de IA 250+ ferramentas hospedadas, pagamento por chamada.
ToolRouter é o OpenRouter para ferramentas. Conecte-se uma vez via MCP e seu agente pode descobrir e chamar 250+ ferramentas especializadas hospedadas: busca na web, scraping, geração de imagem e vídeo, SEO, finanças, imóveis, conformidade e muito mais. Ferramentas gratuitas funcionam imediatamente; ferramentas pagas são pagamento por chamada. Tudo roda no gateway hospedado; nada é executado localmente.
A superfície de roteamento compacta custa ao agente cerca de 9.000 tokens de contexto para o catálogo inteiro, versus aproximadamente 257.000 tokens se cada habilidade fosse carregada como uma ferramenta própria (medido em 2026-09-03; método e dados brutos em https://toolrouter.com/blog/mcp-tool-schema-token-cost).
Conecte-se em uma linha
Endpoint hospedado: https://api.toolrouter.com/mcp (HTTP streamable). Nenhuma chave de API necessária — o servidor provisiona uma conta gratuita na primeira conexão e retorna um link de reivindicação.
Claude Code
claude mcp add --transport http toolrouter https://api.toolrouter.com/mcp
Claude (chat, Desktop, mobile)
Personalizar → Conectores → Adicionar conector personalizado, nomeie-o ToolRouter, URL https://api.toolrouter.com/mcp/anthropic.
Cursor
Adicione a .cursor/mcp.json:
{
"mcpServers": {
"toolrouter": {
"url": "https://api.toolrouter.com/mcp"
}
}
}
VS Code
Adicione a .vscode/mcp.json:
{
"servers": {
"toolrouter": {
"type": "http",
"url": "https://api.toolrouter.com/mcp"
}
}
}
Gemini CLI
Adicione a ~/.gemini/settings.json:
{
"mcpServers": {
"toolrouter": {
"httpUrl": "https://api.toolrouter.com/mcp"
}
}
}
Windsurf
Adicione a ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"toolrouter": {
"serverUrl": "https://api.toolrouter.com/mcp"
}
}
}
Qualquer outro cliente MCP que fale HTTP streamable pode usar a mesma URL.
Ponte local (npm)
toolrouter-mcp é uma ponte stdio para o mesmo gateway hospedado, além de um CLI. Use-o onde um cliente não pode aceitar uma URL remota.
Três maneiras de usar
1. Servidor MCP (para agentes de IA)
Execute sem argumentos para iniciar um servidor MCP stdio. Nenhuma chave de API necessária — provisiona automaticamente no primeiro uso:
npx -y toolrouter-mcp
2. CLI (para fluxos de trabalho em terminal)
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. API REST (HTTP direto)
# 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
Instale a ponte local
Codex CLI
codex mcp add toolrouter -- npx -y toolrouter-mcp
Cursor
Adicione a .cursor/mcp.json:
{
"mcpServers": {
"toolrouter": {
"command": "npx",
"args": ["-y", "toolrouter-mcp"]
}
}
}
Windsurf
Adicione a ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"toolrouter": {
"command": "npx",
"args": ["-y", "toolrouter-mcp"]
}
}
}
OpenClaw
Adicione a openclaw.json:
{
"mcpServers": {
"toolrouter": {
"command": "npx",
"args": ["-y", "toolrouter-mcp"]
}
}
}
Cline
Abra as configurações do MCP e adicione:
{
"mcpServers": {
"toolrouter": {
"command": "npx",
"args": ["-y", "toolrouter-mcp"]
}
}
}
VS Code
Adicione a .vscode/mcp.json:
{
"servers": {
"toolrouter": {
"type": "stdio",
"command": "npx",
"args": ["-y", "toolrouter-mcp"]
}
}
}
Gemini CLI
Adicione às configurações do seu Gemini CLI:
{
"mcpServers": {
"toolrouter": {
"command": "npx",
"args": ["-y", "toolrouter-mcp"]
}
}
}
Claude Desktop
Adicione a claude_desktop_config.json:
{
"mcpServers": {
"toolrouter": {
"command": "npx",
"args": ["-y", "toolrouter-mcp"]
}
}
}
Chave de API
Nenhuma configuração necessária — toolrouter-mcp provisiona automaticamente uma chave de API gratuita no primeiro uso e a armazena em cache em ~/.toolrouter/key. Ferramentas gratuitas funcionam imediatamente. Para ferramentas pagas, visite a URL de reivindicação impressa na primeira execução para adicionar créditos.
Para usar uma chave existente: defina TOOLROUTER_API_KEY=tr_live_xxx como uma variável de ambiente.
Como Funciona
Este pacote serve a dois propósitos a partir de um único binário:
- Modo MCP (sem argumentos): Inicia um servidor MCP stdio que faz proxy de
tools/listetools/callpara a API ToolRouter via HTTP Streamable. - Modo CLI (
tools/search/call/help): Cliente HTTP leve que envia solicitações para a API ToolRouter e imprime resultados. Nenhuma execução local de ferramentas.
Ambos os modos passam por https://api.toolrouter.com — todo o processamento acontece na infraestrutura do ToolRouter.
Meta-Ferramentas MCP
Quando conectado via MCP, seu agente recebe meta-ferramentas para descoberta de ferramentas, execução, trabalhos assíncronos e gerenciamento completo da conta:
Descoberta e execução:
| Ferramenta | Descrição |
|---|---|
discover | Encontre ferramentas por palavra-chave, categoria ou * para todas |
use_tool | Execute uma habilidade de ferramenta |
job_get | Consulte o status e o resultado de um trabalho assíncrono |
job_list | Liste trabalhos assíncronos recentes |
job_cancel | Cancele um trabalho assíncrono em execução |
Créditos e cobrança:
| Ferramenta | Descrição |
|---|---|
credits_balance | Obtenha o saldo de créditos disponível |
credits_usage | Detalhamento de uso e histórico de chamadas recentes |
top_up_credits | Adicione créditos |
subscription_manage | Veja ou altere sua assinatura |
invoice_list | Liste faturas |
Chaves de API:
| Ferramenta | Descrição |
|---|---|
key_create | Crie uma nova chave de API |
key_list | Liste chaves de API |
key_delete | Desative permanentemente uma chave de API |
Credenciais (BYOK):
| Ferramenta | Descrição |
|---|---|
credential_save | Salve sua própria chave de API do provedor |
credential_list | Liste credenciais salvas |
credential_delete | Remova uma credencial salva |
credential_default | Defina a credencial padrão para um provedor |
Conectores e conta:
| Ferramenta | Descrição |
|---|---|
connector_add | Conecte uma conta SaaS via OAuth |
connector_list | Liste contas conectadas |
account_preferences | Veja e atualize as configurações da conta |
feedback_review | Avalie uma ferramenta |
Variáveis de Ambiente
| Variável | Obrigatória | Padrão | Descrição |
|---|---|---|---|
TOOLROUTER_API_KEY | Sim (para chamadas de ferramentas) | — | Sua chave de API |
TOOLROUTER_API_URL | Não | https://api.toolrouter.com | Endpoint de API personalizado |
Referência do CLI
| Comando | Autenticação Necessária | Descrição |
|---|---|---|
tools | Não | Liste todas as ferramentas disponíveis |
search <query> | Não | Pesquise ferramentas por palavra-chave |
call <tool> <skill> [opts] | Sim | Chame uma habilidade de ferramenta |
help | Não | Mostre ajuda de uso |
Métodos de entrada para 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"}'
Requisitos
- Node.js 22+
Links
- Site
- Guia de Conexão / Configuração
- Navegar pelas Ferramentas
- Documentação
- API REST
- Política de Privacidade
- Termos
Política de Privacidade
https://toolrouter.com/privacy