Saltar al contenido principal

MCP para agentes de IA

Ishtaran tiene un servidor MCP (Model Context Protocol) oficial para agentes de IA. Si estás construyendo con Claude, Codex, Cursor o cualquier otro cliente compatible con MCP, conéctalo antes de escribir una sola línea de código de integración — le enseña al agente las capacidades reales de Ishtaran, planifica una integración y valida un plan propuesto, fundamentado en el contrato público real de la API y los SDKs, no en suposiciones del modelo.

LLM piensa  ->  MCP enseña/planifica/valida  ->  SDK ejecuta la integración  ->  API ejecuta el negocio

@ishtaran/mcp nunca ejecuta operaciones financieras — ningún depósito, settlement, payout, withdrawal o refund. Solo conoce, planifica y valida. Tu integración sigue corriendo en uno de los SDKs oficiales; el MCP solo garantiza que el agente que la construye no alucine un endpoint, método de SDK, código de error o evento de webhook que no existe.

Instalación​

No se requiere API Key ni variable de entorno — todas las tools y resources funcionan completamente offline, justo después de instalar.

Claude Code​

Agrega esto a tu .mcp.json del proyecto (o ejecuta claude mcp add):

{
  "mcpServers": {
    "ishtaran": {
      "command": "npx",
      "args": ["-y", "@ishtaran/mcp"]
    }
  }
}

Cursor​

Settings → MCP → Add new MCP server, mismo command/args de arriba.

VS Code (o cualquier otro cliente MCP basado en stdio)​

Apunta el cliente al comando npx -y @ishtaran/mcp sin argumentos.

Qué sabe​

  • Capabilities y operaciones — cada operación pública de la API, con el método real de SDK por lenguaje (TypeScript, Java, Python y Go), extraído directamente del código fuente de cada SDK.
  • Errores — significado, si es retryable y la remediación real de cada código de error documentado.
  • Webhooks — el contrato completo de entrega (headers, fórmula de firma HMAC, reglas de retry/orden) y el catálogo real de eventos.
  • Recipes — patrones completos de integración (empezando por el ejemplo de marketplace Mercatto), incluyendo invariantes y anti-patrones conocidos.
  • Gaps conocidos — lo que la plataforma genuinamente no soporta todavía, para que el agente nunca invente un workaround para algo que nunca fue posible.

Pregúntale cosas como "¿Cómo integro Ishtaran?", "Construye un marketplace usando Ishtaran", "¿Cómo verifico un webhook de Ishtaran?" o "Explica NETWORK_EXECUTION_FEE_INSUFFICIENT_BALANCE."

Mantenerse actualizado sin reinstalar​

La versión del paquete del MCP y el conocimiento que trae (docs, superficie de la API, recipes, reference projects) se versionan de forma independiente. Nuevas docs, rutas, capabilities, recipes o reference projects llegan a un MCP ya instalado a través de una pequeña actualización de conocimiento, firmada y content-addressed, que verifica en segundo plano — no necesitas volver a ejecutar npx @ishtaran/mcp ni reinstalar nada para recibirlos. Consulta el README del repositorio para el funcionamiento exacto de esto.

Código fuente​

@ishtaran/mcp es Apache-2.0 y público: github.com/taylorjeftedasilva/ishtaran-mcp · npm