Skip to main content
CUCU AI

​
Tu AI ya sabe facturar

12 herramientas MCP. Lenguaje natural. Facturacion electronica completa sin escribir una sola linea de codigo.

MCP es el nuevo REST

Asi como las APIs REST reemplazaron a SOAP, el Model Context Protocol esta reemplazando la integracion manual. Tu agente AI ejecuta las herramientas directamente.

​
Que es MCP?

El Model Context Protocol es un estandar abierto creado por Anthropic que permite a los modelos de AI interactuar con herramientas externas de forma segura y tipada.
1

Tu le pides al AI en lenguaje natural

“Emite una factura a EMPRESA TECH S.R.L. por Bs. 1,500 de consultoria”
2

MCP traduce a la herramienta correcta

El protocolo identifica crearFactura, construye los parametros tipados y ejecuta
3

CUCU ejecuta contra el SIAT

Firma digital, validacion fiscal, generacion de PDF/XML, envio de email — todo automatico
4

El resultado vuelve al AI

Te confirma: “Factura #42 emitida. CUF: 2872F4A1… Estado: VALIDADA. PDF enviado.”
MCP funciona con cualquier modelo: Claude (Anthropic), GPT (OpenAI), Gemini (Google), modelos locales via Ollama, y cualquier cliente compatible con Streamable HTTP.

​
Arquitectura

MCP Clients
Claude DesktopCursorWindsurfVS CodeClaude CodeAny MCP client
POST /mcp — Streamable HTTP — Header: X-API-Key
CUCU MCP Server
12 tools — Streamable HTTP + SSE fallback
Facturacion (6)
crearFactura()listarFacturas()obtenerFactura()anularFactura()obtenerPdf()reenviarEmail()
Utilidades SIAT (6)
verificarNit()consultarNit()sincCatalogos()verificarSiat()consultarNormativa()estadoSistema()
SOAP / JDBC / S3 SDK / gRPC
Infrastructure
SIAT
SOAP · SIN Bolivia
PostgreSQL
JDBC · RDS
S3
SDK · PDF/XML
Qdrant
gRPC · RAG

​
Las 12 herramientas

​
Facturacion

El ciclo completo de facturacion electronica en 6 herramientas.

crearFactura

Emite una factura electronica completa. Firma digital, CUF, validacion SIAT, PDF/XML y email al cliente. Soporta contingencia automatica.

listarFacturas

Lista facturas con filtros por fecha, estado, NIT, numero. Paginacion incluida. Ideal para reportes y conciliaciones.

obtenerFactura

Detalle completo de una factura: datos fiscales, CUF, estado SIAT, items, montos, impuestos y metadata.

anularFactura

Anula una factura ante el SIAT con motivo del catalogo SIN. Registra la anulacion y notifica al cliente.

obtenerPdfFactura

Descarga el PDF en formato A4 o ticket 80mm. Incluye QR, CUF y todos los datos normativos requeridos.

reenviarEmailFactura

Reenvia la factura por email al cliente o a otra direccion. Util cuando no recibio el correo original.

​
Utilidades SIAT

Herramientas de soporte para operaciones fiscales y diagnostico.

verificarFormatoNit

Valida formato NIT segun algoritmo del SIN. Detecta errores de digitacion antes de emitir factura.

consultarNit

Consulta un NIT contra el SIAT para obtener razon social. Verifica que este activo y habilitado.

sincronizarCatalogos

Sincroniza catalogos SIAT: actividades economicas, productos, tipos de documento, motivos de anulacion.

verificarComunicacion

Diagnostica conectividad con el SIAT en tiempo real. Detecta si debe activarse el modo contingencia.

consultarNormativa

Consulta normativa tributaria usando RAG con Qdrant. Responde preguntas sobre regulaciones y requisitos fiscales.

obtenerEstadoSistema

Estado del sistema: conexion SIAT, BD, servicios, version de catalogos y metricas de salud.

​
Ejemplo en vivo

Asi se ve una sesion real usando MCP desde Claude Desktop:
1

Tu le pides al AI

Emite una factura a EMPRESA TECH S.R.L. con NIT 1234567
por Bs. 1,500 de servicio de consultoria en tecnologia
2

El AI ejecuta crearFactura

El AI identifica la herramienta correcta, construye los parametros y ejecuta:
{
  "tool": "crearFactura",
  "arguments": {
    "nitCliente": "1234567",
    "razonSocial": "EMPRESA TECH S.R.L.",
    "detalle": [{
      "descripcion": "Servicio de consultoria en tecnologia",
      "cantidad": 1,
      "precioUnitario": 1500.00,
      "codigoProductoSin": 86101
    }]
  }
}
3

Recibes la confirmacion

El AI te responde en lenguaje natural:
Factura #42 emitida exitosamente:

- CUF: 2872F4A1C0E8B3D5...
- Cliente: EMPRESA TECH S.R.L. (NIT 1234567)
- Monto: Bs. 1,500.00
- Estado: VALIDADA por el SIAT
- PDF y email enviados automaticamente
4

Puedes seguir operando

Ahora anulala por error en los datos del cliente
El AI ejecuta anularFactura con el motivo correspondiente y te confirma la anulacion ante el SIAT.
Las operaciones MCP son reales. Si estas en sandbox (sk_test_), se ejecutan contra el SIAT piloto. Si usas una key de produccion (sk_live_), las facturas son fiscalmente validas ante el SIN. Trata las herramientas MCP con el mismo cuidado que una llamada API.

​
Clientes compatibles

ClientePlataformaProtocoloEstado
Claude DesktopmacOS, WindowsStreamable HTTPSoportado
CursormacOS, Windows, LinuxStreamable HTTPSoportado
WindsurfmacOS, Windows, LinuxStreamable HTTPSoportado
VS Code (GitHub Copilot)macOS, Windows, LinuxStreamable HTTPSoportado
Claude Code (CLI)macOS, LinuxStreamable HTTPSoportado
Continue.devVS Code, JetBrainsSSESoportado
Clientes customCualquieraStreamable HTTP / SSESoportado
Si tu cliente solo soporta SSE (legacy), usa el endpoint /mcp/sse en lugar de /mcp. Ambos protocolos usan la misma autenticacion y herramientas.

​
Siguiente paso

Configurar MCP

Conecta Claude Desktop, Cursor, Windsurf, VS Code o Claude Code al MCP Server. Listo en 2 minutos.

Referencia de herramientas

Documentacion detallada de las 12 herramientas: parametros, schemas, codigos de error y ejemplos reales.
CUCU

​
Integra facturacion con AI

Conecta tu editor o asistente AI al MCP Server de CUCU. Emite facturas con lenguaje natural. Sin codigo, sin documentacion, sin friccion.

Obtener API Key gratuita →