Conectar por MCP

istmobot expone un servidor MCP remoto y abierto: cualquiera lo conecta a Claude, Cursor, ChatGPT u otro cliente compatible, sin cuenta ni API key. El asistente conoce el catálogo, los esquemas de respuesta y la guía de integración, y escribe el código que llama a la API desde tu sistema. Tu key queda en tu .env; el asistente nunca la necesita.

Datos de conexión

URL	`https://api.istmobot.com/mcp`
Transporte	Streamable HTTP (sin sesiones)
Autenticación	Ninguna. Opcional: `Authorization: Bearer ib_live_...` para procesar de verdad desde el asistente.

Dos modos

Sin key (por defecto). listar_soluciones, esquema_solucion y guia_integracion funcionan completos. consultar_* y enviar_* responden con datos de ejemplo que tienen la forma exacta del resultado real: suficiente para programar, probar el parseo y escribir tests. No consume créditos.
Con key. Si el cliente MCP envía el header Authorization, las mismas tools llaman a la API HTTP con tu key: procesan documentos reales y descuentan créditos igual que una llamada directa (ib_test_ sigue devolviendo ejemplos).

Tools disponibles

Tool	Qué hace	Créditos
`listar_soluciones`	Catálogo de soluciones con endpoint y costo.	0
`esquema_solucion`	Endpoints, esquema JSON de la respuesta, ejemplo completo y evento de webhook de una solución. Lo que el asistente necesita para escribir código.	0
`guia_integracion`	Cómo llamar a la API por HTTP, manejar el 202 y verificar webhooks.	0
`enviar_yappy`	Extrae los datos del comprobante Yappy y verifica que el pago se recibió.	2 (0 sin key)
`consultar_factura`	Consulta la factura electrónica en la DGI, por CUFE o desde el documento.	2 (0 sin key)
`enviar_aviso_operacion`	Extrae los datos del Aviso de Operación.	3 (0 sin key)
`enviar_cedula`	Extrae los datos de la cédula panameña.	2 (0 sin key)
`enviar_recibo_ensa`	Extrae los datos del recibo de ENSA.	2 (0 sin key)
`enviar_recibo_naturgy`	Extrae los datos del recibo de Naturgy.	2 (0 sin key)
`enviar_recibo_idaan`	Extrae los datos del recibo de IDAAN.	2 (0 sin key)
`enviar_panapass`	Extrae los datos del estado de cuenta Panapass.	3 (0 sin key)
`estado_documento`	Estado y resultado de un documento enviado con `enviar_*`. Requiere key.	0

Con key, las tools enviar_* reciben el archivo en base64 y responden 202 con un id; el asistente llama a estado_documento hasta que estado sea listo. En base64 el archivo crece un 33 %: el límite práctico por llamada es de unos 3 MB.

Claude Code

claude mcp add --transport http istmobot https://api.istmobot.com/mcp

Luego pídele, por ejemplo: «integra la validación de pagos Yappy de istmobot en mi API de pedidos, leyendo la key de ISTMOBOT_KEY».

Claude Desktop y claude.ai

Ajustes → Conectores → Añadir conector personalizado, con la URL https://api.istmobot.com/mcp y sin autenticación.

Cursor

Crea .cursor/mcp.json en tu proyecto (o ~/.cursor/mcp.json para todos):

{
  "mcpServers": {
    "istmobot": { "url": "https://api.istmobot.com/mcp" }
  }
}

ChatGPT

Ajustes → Conectores (modo desarrollador) → Crear, con la URL https://api.istmobot.com/mcp y autenticación «Ninguna».

Procesar de verdad desde el asistente

Solo en clientes que permiten headers. La key es tuya: no la pegues en chats compartidos.

# Claude Code
claude mcp add --transport http istmobot https://api.istmobot.com/mcp \
  --header "Authorization: Bearer ib_live_..."

# Cursor (.cursor/mcp.json)
{ "mcpServers": { "istmobot": { "url": "https://api.istmobot.com/mcp", "headers": { "Authorization": "Bearer ib_live_..." } } } }

Probar con curl

curl https://api.istmobot.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Con key, cada tool llama al endpoint HTTP equivalente: aplican los mismos créditos y límites y los mismos errores.