Endpoints - CUCU API

Endpoints

Protocolo	Sandbox	Produccion	Recomendado
Streamable HTTP	`https://sandbox.cucu.bo/mcp`	`https://api.cucu.bo/mcp`	Si — todos los clientes modernos
Legacy SSE	`https://sandbox.cucu.bo/mcp/sse`	`https://api.cucu.bo/mcp/sse`	Solo si tu cliente no soporta Streamable HTTP

Todos los endpoints requieren el header X-API-Key: <tu_api_key>. Usa sk_test_ para sandbox y sk_live_ para produccion.

Invocación directa (JSON-RPC 2.0)

No necesitas un editor para probar: el MCP Server responde JSON-RPC estándar. Listar las 45 herramientas:

curl -X POST https://sandbox.cucu.bo/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "X-API-Key: sk_test_..." \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Invocar una herramienta:

curl -X POST https://sandbox.cucu.bo/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "X-API-Key: sk_test_..." \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "verificarFormatoNit",
      "arguments": { "nit": "1023456789" }
    }
  }'

Respuesta:

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      { "type": "text", "text": "El NIT 1023456789 tiene un formato valido." }
    ]
  }
}