@toreador/mcp-server

Servidor oficial del Model Context Protocol para Toreador. Permite que Claude Desktop, Cursor y cualquier otro asistente compatible con MCP generen códigos QR de criptomonedas y gestionen sesiones de pago en tu nombre.

⚠️ Requiere una clave API del plan Pro (tdr_...) desde tu panel de control de Toreador. El servidor MCP se ejecuta localmente y utiliza tu clave para llamar a https://toreador.io/api/v1/public.

Herramientas expuestas

Instalación en Claude Desktop

Edita el archivo de configuración de Claude Desktop:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%/Claude/claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

Añade la entrada toreador bajo mcpServers:

{
  "mcpServers": {
    "toreador": {
      "command": "npx",
      "args": ["-y", "@toreador/mcp-server"],
      "env": {
        "TOREADOR_API_KEY": "tdr_your_key_here"
      }
    }
  }
}

Reinicia Claude Desktop. Deberías ver las 5 herramientas de Toreador en el menú de herramientas.

Instalación en Cursor

En la configuración de Cursor → MCP → "Add new MCP server", pega:

{
  "command": "npx",
  "args": ["-y", "@toreador/mcp-server"],
  "env": { "TOREADOR_API_KEY": "tdr_..." }
}

Ejemplos de prompts

Una vez instalado, prueba estos prompts en tu cliente MCP:

• "Generate a Bitcoin QR code for 0.001 BTC to bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh."

• "Create a USDC payment session for 50 USDC on Polygon to 0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18."

• "What's the status of session ses_123?"

• "Show me my last 10 payment sessions."

El asistente elegirá la herramienta correcta, llamará a Toreador y devolverá el resultado, incluyendo el URI de datos del código QR que la mayoría de los clientes pueden renderizar en línea.

Configuración

Confianza y seguridad

• Solo local. El servidor MCP se ejecuta en tu máquina a través de stdio. Tu clave API nunca sale de tu ordenador, excepto en llamadas HTTPS salientes a toreador.io.

• Sin custodia. Toreador nunca retiene fondos. Las herramientas MCP solo generan códigos QR y leen el estado de la sesión; no pueden mover dinero.

• Leer o crear, sin destrucción. Las herramientas generan nuevos objetos de pago o leen los existentes. No existe una herramienta de "eliminar" o "reembolsar".

Construir desde el código fuente

git clone https://github.com/Bentonabento/toreador-sdk.git
cd toreador-sdk/mcp
npm install
npm run build
TOREADOR_API_KEY=tdr_... node dist/index.js

El servidor se iniciará, imprimirá [toreador-mcp] ready (5 tools registered) en stderr y esperará solicitudes MCP en stdin.

Licencia

MIT