Servidor MCP

TuCapi expone un servidor MCP (Model Context Protocol) para que un asistente de IA consulte su cuenta con su propia llave: el catálogo, sus saldos, cualquier operación por id y sus eventos. Sólo lectura: ninguna herramienta crea, confirma ni cancela operaciones. Las herramientas de escritura llegarán detrás de un alcance propio y de confirmación explícita.

Conectarse

• Por HTTP (ChatGPT, Gemini CLI por url, cualquier cliente MCP con transporte streamable HTTP): POST <URL base>/mcp, con su llave en Authorization: Bearer <llave>. La llave viaja en cada pedido y determina su empresa; el servidor no guarda llaves.
• Por stdio (Claude Code, Gemini CLI, Codex, en su máquina): el binario mcp con las variables TUCAPI_API_URL y TUCAPI_API_KEY. Para el sandbox, TUCAPI_API_URL=https://api.tucapi.app/sandbox con una llave tuc_test_….

Herramientas

Herramienta	Ruta	Qué devuelve
balances_list	GET /v2/balances	Sus saldos por moneda
banks_list	GET /v2/banks	Los bancos de un país
capabilities_get	GET /v2/capabilities	Qué puede hacer su llave hoy
events_list	GET /v2/events	Los eventos de sus operaciones
methods_list	GET /v2/methods	El catálogo de métodos
payins_get	GET /v2/payins/{id}	Consultar un cobro
payouts_get	GET /v2/payouts/{id}	Consultar un pago
transactions_get	GET /v2/transactions/{id}	Consultar cualquier operación

Cada herramienta devuelve el mismo JSON que la ruta correspondiente de la API; los errores llegan como texto con el código estable.

Recursos

• tucapi://openapi: este contrato.
• tucapi://llms.txt: el índice de esta documentación.
• tucapi://docs/<página>: cada página de esta documentación, en Markdown.

Paquetes de integración listos

• Claude: el Agent Skill tucapi-pagos-v2 (SKILL.md con referencias) en integraciones/claude/, también como .zip.
• ChatGPT: el mismo skill y las instrucciones para conectar el servidor MCP en modo desarrollador, en integraciones/chatgpt/.
• Gemini CLI: una extensión (gemini-extension.json, GEMINI.md y el skill) en integraciones/gemini/.

Los tres se generan de esta misma documentación.