MCP Server - CUCU API

El MCP Server expone la API de facturación electrónica de CUCU como herramientas ejecutables por cualquier agente AI. La misma API Key de REST (sk_test_ / sk_live_) habilita ambos.

Conecta tu agente

Claude Code
Claude Desktop
Cursor
VS Code
Otros (Codex, Windsurf…)

claude mcp add --transport http cucu-facturacion https://sandbox.cucu.bo/mcp \
  --header "X-API-Key: YOUR_API_KEY"

O por proyecto, con un archivo .mcp.json:

.mcp.json

{
  "mcpServers": {
    "cucu-facturacion": {
      "type": "url",
      "url": "https://sandbox.cucu.bo/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}

Settings → Developer → Edit Config y pega:

claude_desktop_config.json

{
  "mcpServers": {
    "cucu-facturacion": {
      "url": "https://sandbox.cucu.bo/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}

→ Instalar en Cursor con un clic — después reemplaza YOUR_API_KEY en la config. O manual:

.cursor/mcp.json

{
  "mcpServers": {
    "cucu-facturacion": {
      "url": "https://sandbox.cucu.bo/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "cucu-facturacion": {
      "type": "http",
      "url": "https://sandbox.cucu.bo/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}

Las herramientas aparecen en GitHub Copilot en modo Agent.

Cualquier cliente MCP: apunta a la URL con el header X-API-Key. Si tu cliente solo soporta stdio, usa el puente mcp-remote:

npx mcp-remote https://sandbox.cucu.bo/mcp --header "X-API-Key: YOUR_API_KEY"

Paso a paso por cliente (Windsurf incluido): Quickstart.

Contrata tu plan con el agente de CUCU por WhatsApp y recibe tu API Key en la misma conversación, 24/7 — o en app.cucu.bo. sk_test_ conecta al sandbox (SIAT Piloto); sk_live_ a producción.

Endpoints

	Sandbox	Producción
Streamable HTTP	`https://sandbox.cucu.bo/mcp`	`https://api.cucu.bo/mcp`
Legacy SSE	`https://sandbox.cucu.bo/mcp/sse`	`https://api.cucu.bo/mcp/sse`
Auth (header)	`X-API-Key: sk_test_...`	`X-API-Key: sk_live_...`

Las 41 herramientas

Categoría	Tools	Referencia
Facturación	10	crearFactura, anularFactura, notas de crédito/débito…
Contingencia y eventos	7	abrirEvento, resellarFacturasEvento…
Utilidades SIAT	7	verificarFormatoNit, consultarDatosNit, buscarNormativa…
Webhooks	8	registrarWebhook, rotarSecretoWebhook…
Administración	9	crearTenantCompleto, generarApiKey…

Quickstart

Paso a paso por cliente, con verificación.

Cómo funciona

Del lenguaje natural a la factura validada.

Avanzado

Producción, dual environments, clientes custom.

​Conecta tu agente

​Endpoints

​Las 41 herramientas

Quickstart

Cómo funciona

Avanzado

Conecta tu agente

Endpoints

Las 41 herramientas