ToolRouter
El OpenRouter para herramientas. Una conexión MCP le da a cualquier agente de IA más de 250 herramientas alojadas, pago por llamada.
Documentación
ToolRouter — el OpenRouter para herramientas
El OpenRouter para herramientas. Una conexión MCP le da a cualquier agente de IA más de 250 herramientas alojadas, pago por llamada.
ToolRouter es el OpenRouter para herramientas. Conéctate una vez a través de MCP y tu agente podrá descubrir y usar más de 250 herramientas especializadas alojadas: búsqueda web, scraping, generación de imágenes y video, SEO, finanzas, propiedades, cumplimiento y más. Las herramientas gratuitas funcionan de inmediato; las herramientas de pago se cobran por llamada. Todo se ejecuta en la puerta de enlace alojada; nada se ejecuta localmente.
La superficie de enrutamiento compacta le cuesta a un agente alrededor de 9,000 tokens de contexto para todo el catálogo, frente a aproximadamente 257,000 tokens si cada habilidad se cargara como su propia herramienta (medido el 2026-09-03; método y datos brutos en https://toolrouter.com/blog/mcp-tool-schema-token-cost).
Conéctate en una línea
Endpoint alojado: https://api.toolrouter.com/mcp (HTTP transmisible). No se necesita clave API — el servidor crea una cuenta gratuita en la primera conexión y devuelve un enlace de reclamación.
Claude Code
claude mcp add --transport http toolrouter https://api.toolrouter.com/mcp
Claude (chat, Desktop, móvil)
Personalizar → Conectores → Añadir conector personalizado, nómbralo ToolRouter, URL https://api.toolrouter.com/mcp/anthropic.
Cursor
Añade a .cursor/mcp.json:
{
"mcpServers": {
"toolrouter": {
"url": "https://api.toolrouter.com/mcp"
}
}
}
VS Code
Añade a .vscode/mcp.json:
{
"servers": {
"toolrouter": {
"type": "http",
"url": "https://api.toolrouter.com/mcp"
}
}
}
Gemini CLI
Añade a ~/.gemini/settings.json:
{
"mcpServers": {
"toolrouter": {
"httpUrl": "https://api.toolrouter.com/mcp"
}
}
}
Windsurf
Añade a ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"toolrouter": {
"serverUrl": "https://api.toolrouter.com/mcp"
}
}
}
Cualquier otro cliente MCP que hable HTTP transmisible puede usar la misma URL.
Puente local (npm)
toolrouter-mcp es un puente stdio hacia la misma puerta de enlace alojada, además de una CLI. Úsalo donde un cliente no pueda aceptar una URL remota.
Tres formas de usarlo
1. Servidor MCP (para agentes de IA)
Ejecuta sin argumentos para iniciar un servidor MCP stdio. No se necesita clave API — se autoaprovisiona en el primer uso:
npx -y toolrouter-mcp
2. CLI (para flujos de trabajo en 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 directo)
# 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
Instala el puente local
Codex CLI
codex mcp add toolrouter -- npx -y toolrouter-mcp
Cursor
Añade a .cursor/mcp.json:
{
"mcpServers": {
"toolrouter": {
"command": "npx",
"args": ["-y", "toolrouter-mcp"]
}
}
}
Windsurf
Añade a ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"toolrouter": {
"command": "npx",
"args": ["-y", "toolrouter-mcp"]
}
}
}
OpenClaw
Añade a openclaw.json:
{
"mcpServers": {
"toolrouter": {
"command": "npx",
"args": ["-y", "toolrouter-mcp"]
}
}
}
Cline
Abre la configuración de MCP y añade:
{
"mcpServers": {
"toolrouter": {
"command": "npx",
"args": ["-y", "toolrouter-mcp"]
}
}
}
VS Code
Añade a .vscode/mcp.json:
{
"servers": {
"toolrouter": {
"type": "stdio",
"command": "npx",
"args": ["-y", "toolrouter-mcp"]
}
}
}
Gemini CLI
Añade a la configuración de tu Gemini CLI:
{
"mcpServers": {
"toolrouter": {
"command": "npx",
"args": ["-y", "toolrouter-mcp"]
}
}
}
Claude Desktop
Añade a claude_desktop_config.json:
{
"mcpServers": {
"toolrouter": {
"command": "npx",
"args": ["-y", "toolrouter-mcp"]
}
}
}
Clave API
No se necesita configuración — toolrouter-mcp autoaprovisiona una clave API gratuita en el primer uso y la guarda en caché en ~/.toolrouter/key. Las herramientas gratuitas funcionan de inmediato. Para herramientas de pago, visita la URL de reclamación impresa en la primera ejecución para añadir créditos.
Para usar una clave existente: establece TOOLROUTER_API_KEY=tr_live_xxx como variable de entorno.
Cómo funciona
Este paquete sirve dos propósitos desde un solo binario:
- Modo MCP (sin argumentos): Inicia un servidor MCP stdio que hace de proxy de
tools/listytools/callhacia la API de ToolRouter a través de HTTP transmisible. - Modo CLI (
tools/search/call/help): Cliente HTTP ligero que envía solicitudes a la API de ToolRouter e imprime los resultados. Sin ejecución local de herramientas.
Ambos modos pasan por https://api.toolrouter.com — todo el procesamiento ocurre en la infraestructura de ToolRouter.
Meta-herramientas MCP
Cuando te conectas a través de MCP, tu agente obtiene meta-herramientas para descubrimiento de herramientas, ejecución, trabajos asíncronos y gestión completa de la cuenta:
Descubrimiento y ejecución:
| Herramienta | Descripción |
|---|---|
discover | Encuentra herramientas por palabra clave, categoría o * para todas |
use_tool | Ejecuta una habilidad de herramienta |
job_get | Consulta el estado y resultado de un trabajo asíncrono |
job_list | Lista trabajos asíncronos recientes |
job_cancel | Cancela un trabajo asíncrono en ejecución |
Créditos y facturación:
| Herramienta | Descripción |
|---|---|
credits_balance | Obtén el saldo de crédito disponible |
credits_usage | Desglose de uso e historial de llamadas recientes |
top_up_credits | Añade créditos |
subscription_manage | Ver o cambiar tu suscripción |
invoice_list | Lista de facturas |
Claves API:
| Herramienta | Descripción |
|---|---|
key_create | Crea una nueva clave API |
key_list | Lista de claves API |
key_delete | Deshabilita permanentemente una clave API |
Credenciales (BYOK):
| Herramienta | Descripción |
|---|---|
credential_save | Guarda tu propia clave API de proveedor |
credential_list | Lista de credenciales guardadas |
credential_delete | Elimina una credencial guardada |
credential_default | Establece la credencial predeterminada para un proveedor |
Conectores y cuenta:
| Herramienta | Descripción |
|---|---|
connector_add | Conecta una cuenta SaaS mediante OAuth |
connector_list | Lista de cuentas conectadas |
account_preferences | Ver y actualizar la configuración de la cuenta |
feedback_review | Califica una herramienta |
Variables de entorno
| Variable | Requerida | Predeterminado | Descripción |
|---|---|---|---|
TOOLROUTER_API_KEY | Sí (para llamadas a herramientas) | — | Tu clave API |
TOOLROUTER_API_URL | No | https://api.toolrouter.com | Endpoint API personalizado |
Referencia CLI
| Comando | Autenticación requerida | Descripción |
|---|---|---|
tools | No | Lista todas las herramientas disponibles |
search <query> | No | Busca herramientas por palabra clave |
call <tool> <skill> [opts] | Sí | Llama a una habilidad de herramienta |
help | No | Muestra ayuda 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+
Enlaces
- Sitio web
- Guía de conexión / configuración
- Explorar herramientas
- Documentación
- API REST
- Política de privacidad
- Términos
Política de privacidad
https://toolrouter.com/privacy