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/list e tools/call para 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:

FerramentaDescrição
discoverEncontre ferramentas por palavra-chave, categoria ou * para todas
use_toolExecute uma habilidade de ferramenta
job_getConsulte o status e o resultado de um trabalho assíncrono
job_listListe trabalhos assíncronos recentes
job_cancelCancele um trabalho assíncrono em execução

Créditos e cobrança:

FerramentaDescrição
credits_balanceObtenha o saldo de créditos disponível
credits_usageDetalhamento de uso e histórico de chamadas recentes
top_up_creditsAdicione créditos
subscription_manageVeja ou altere sua assinatura
invoice_listListe faturas

Chaves de API:

FerramentaDescrição
key_createCrie uma nova chave de API
key_listListe chaves de API
key_deleteDesative permanentemente uma chave de API

Credenciais (BYOK):

FerramentaDescrição
credential_saveSalve sua própria chave de API do provedor
credential_listListe credenciais salvas
credential_deleteRemova uma credencial salva
credential_defaultDefina a credencial padrão para um provedor

Conectores e conta:

FerramentaDescrição
connector_addConecte uma conta SaaS via OAuth
connector_listListe contas conectadas
account_preferencesVeja e atualize as configurações da conta
feedback_reviewAvalie uma ferramenta

Variáveis de Ambiente

VariávelObrigatóriaPadrãoDescrição
TOOLROUTER_API_KEYSim (para chamadas de ferramentas)—Sua chave de API
TOOLROUTER_API_URLNãohttps://api.toolrouter.comEndpoint de API personalizado

Referência do CLI

ComandoAutenticação NecessáriaDescrição
toolsNãoListe todas as ferramentas disponíveis
search <query>NãoPesquise ferramentas por palavra-chave
call <tool> <skill> [opts]SimChame uma habilidade de ferramenta
helpNãoMostre 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

Política de Privacidade

https://toolrouter.com/privacy

Suporte

support@toolrouter.com