Model Context Protocol
Códigos QR cripto, en el idioma que su IA ya habla.
Conecte Toreador a Claude Desktop, Cursor, Windsurf o cualquier asistente compatible con MCP en 30 segundos. Luego solo pida: «generar un código QR de Bitcoin por 0.001 BTC a bc1q…». El asistente llama a Toreador, recibe el QR y se lo muestra.
Instalación en 30 segundos
Cada herramienta requiere una clave API, incluida en todos los planes, también en el plan gratuito. No hay acceso anónimo.
tor_test_
Clave de prueba (sandbox)
Una clave tor_test_… ejecuta todas las herramientas en redes de prueba (Sepolia, Polygon Amoy, Base Sepolia, Solana Devnet), fuera de cualquier cuota. Ideal para probar la integración sin fondos reales.
tor_live_ · Recomendado
Clave de producción (mainnet)
Una clave tor_live_… crea solicitudes de pago reales en la red principal (mainnet). El límite de solicitudes por minuto y la cuota mensual de pagos con seguimiento dependen de su plan.
Genere sus claves API en su panel.
Herramientas disponibles
El servidor MCP ofrece las siguientes herramientas. Todas requieren una clave API.
| Herramienta | Descripción |
|---|---|
toreador_create_checkout |
Crear una solicitud de pago en USD o en EUR y obtener el enlace de su página de pago alojada, donde el pagador elige la stablecoin y la red. La herramienta principal para cobrar. |
toreador_get_payment |
Consultar un pago por su identificador de checkout o de sesión: estado, token, red, monto, hash de la transacción y cronología. |
toreador_list_payments |
Listar los pagos con seguimiento recientes de todo el equipo, del más reciente al más antiguo, con estado, montos, hash de la transacción, referencia y establecimiento. Paginado; puede limitarse a un establecimiento. |
toreador_list_wallets |
Listar las wallets de recepción registradas en la cuenta. Un pago solo puede ir a una de ellas. |
toreador_list_establishments |
Listar los establecimientos de la organización. Un identificador limita la lista de pagos a un punto de venta, o le asocia una nueva solicitud de pago. |
toreador_list_tokens |
Listar los pares de token y red disponibles para el entorno de la clave (producción o prueba). |
toreador_get_account |
Consultar la cuenta de la clave: plan, entorno, cuota mensual usada y restante. |
toreador_generate_qr |
Generar un código QR directo para una moneda nativa (BTC, ETH, SOL, POL y otras) o un token en Solana, como imagen o como texto para una terminal. El pago no tiene seguimiento. |
toreador_create_session |
Avanzado: crear un pago con seguimiento en una stablecoin y una red determinadas, por ejemplo exactamente 100 USDC en Base, con su página de pago alojada. |
toreador_screen_address |
Verificar una dirección frente a las listas de sanciones: limpia, sancionada o desconocida. |
Aplicaciones compatibles
Cualquier cliente compatible con MCP. La misma configuración JSON en todas partes — solo cambia la ubicación del archivo.
Claude Desktop
Edite ~/Library/Application Support/Claude/claude_desktop_config.json y añada el fragmento de abajo. Reinicie la aplicación: Toreador aparece en el panel de herramientas.
Cursor
Settings → MCP → New MCP server. Pegue el mismo JSON, con alcance de proyecto o global.
Windsurf
Settings → Cascade → MCP Servers → Edit JSON. La misma configuración.
Other MCP-capable hosts
Cualquier cliente que hable Model Context Protocol por stdio puede iniciar el servidor con npx -y @toreador/mcp-server.
¿Por qué MCP y no la API REST?
MCP y la API REST sirven a públicos distintos. Use la API REST cuando escriba código de backend que necesite un comportamiento determinista — páginas de pago, tareas cron, sincronización del estado de los pedidos. Use el servidor MCP cuando una persona (o un agente de IA en su nombre) quiera generar un QR puntual, en una conversación, sin escribir código.
El mismo backend impulsa ambos. Todo lo que puede hacer mediante MCP también puede hacerlo mediante REST. El servidor MCP es solo un adaptador stdio ligero que traduce las llamadas a herramientas de su asistente en llamadas HTTPS a la API de Toreador.
¿Todo listo para que su IA cree solicitudes de pago cripto?
Empiece gratis, sin tarjeta. Todos los planes incluyen la API y el SDK; cambie a un plan superior desde su panel cuando necesite una cuota mayor de pagos con seguimiento.