Tu AI ya sabe facturar

14 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.

Como funciona

Tu le pides al AI en lenguaje natural

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

MCP traduce a la herramienta correcta

El protocolo identifica crearFactura, construye los parametros tipados y ejecuta

CUCU ejecuta contra el SIAT

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

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
14 tools — Streamable HTTP + SSE fallback
Facturacion (8)
crearFactura()listarFacturas()obtenerFactura()obtenerFacturaPorCuf()anularFactura()verificarEstadoFactura()crearNotaCreditoDebito()resumenFacturacion()
Utilidades SIAT (6)
verificarFormatoNit()historialCliente()buscarNormativa()erroresComunesSiat()buscarContingencias()calcularMontoLiteral()

SOAP / JDBC / S3 SDK / gRPC

Infrastructure
SIAT
SOAP · SIN Bolivia
PostgreSQL
JDBC · RDS
S3
SDK · PDF/XML
Qdrant
gRPC · RAG

Las 14 herramientas

Facturacion

El ciclo completo de facturacion electronica en 8 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.

obtenerFacturaPorCuf

Obtiene una factura por su CUF (Codigo Unico de Factura), el identificador unico ante el SIN.

verificarEstadoFactura

Verifica el estado actual de una factura directamente con el SIAT. Estados: VALIDATED, REJECTED, CANCELLED, PENDING, CONTINGENCY.

crearNotaCreditoDebito

Emite nota de credito o debito contra una factura validada. Devoluciones parciales o totales con validacion SIAT sector 24.

resumenFacturacion

Dashboard de facturacion: total facturas, montos, estados, facturas recientes y metricas del periodo.

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.

historialCliente

Historial de facturacion de un cliente por NIT. Razon social, email, telefono y cantidad de facturas emitidas.

buscarNormativa

Busqueda semantica (RAG) en normativa tributaria SIAT. Responde preguntas sobre regulaciones y requisitos fiscales.

erroresComunesSiat

Lista errores frecuentes del SIAT con codigos, descripciones y soluciones recomendadas.

buscarContingencias

Busqueda RAG en historial de contingencias. Caidas SIAT, duracion, patrones y puntos de venta afectados.

calcularMontoLiteral

Convierte un monto numerico a texto literal en bolivianos. Requerido por normativa SIAT en cada factura.

Ejemplo en vivo

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

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

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
    }]
  }
}

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

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.

Tu AI ya maneja la complejidad del SIAT — WSDL que cambian sin aviso, firma digital PKCS#12, rotacion de CUFD cada 24 horas, contingencia offline, 15 tipos de documento sector y normativas que se actualizan constantemente. Un error ante el SIN puede significar multa. Con CUCU + MCP, tu AI factura en segundos y nosotros mantenemos la certificacion al dia.

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

Clientes compatibles

Cliente	Plataforma	Protocolo	Estado
Claude Desktop	macOS, Windows	Streamable HTTP	Soportado
Cursor	macOS, Windows, Linux	Streamable HTTP	Soportado
Windsurf	macOS, Windows, Linux	Streamable HTTP	Soportado
VS Code (GitHub Copilot)	macOS, Windows, Linux	Streamable HTTP	Soportado
Claude Code (CLI)	macOS, Linux	Streamable HTTP	Soportado
Continue.dev	VS Code, JetBrains	SSE	Soportado
Clientes custom	Cualquiera	Streamable HTTP / SSE	Soportado

Siguiente paso

Quickstart

Conecta tu editor al MCP Server en 2 minutos. Paso a paso para 5 clientes.

Referencia de Tools

Documentacion detallada de las 14 herramientas: parametros, schemas y ejemplos.

Avanzado

Produccion, dual environments, troubleshooting y clientes custom.

Integra facturacion con AI

Conecta tu editor o asistente AI al MCP Server de CUCU. Emite facturas con lenguaje natural. Quedate tranquilo con las actualizaciones normativas del SIAT — nosotros mantenemos la certificacion.

Activar Plan →

MCP Server

​Tu AI ya sabe facturar

​Como funciona

​Arquitectura

​Las 14 herramientas

​Facturacion

crearFactura

listarFacturas

obtenerFactura

anularFactura

obtenerFacturaPorCuf

verificarEstadoFactura

crearNotaCreditoDebito

resumenFacturacion

​Utilidades SIAT

verificarFormatoNit

historialCliente

buscarNormativa

erroresComunesSiat

buscarContingencias

calcularMontoLiteral

​Ejemplo en vivo

​Endpoints

​Clientes compatibles

​Siguiente paso

Quickstart

Referencia de Tools

Avanzado

​Integra facturacion con AI

Tu AI ya sabe facturar

Como funciona

Arquitectura

Las 14 herramientas

Facturacion

Utilidades SIAT

Ejemplo en vivo

Endpoints

Clientes compatibles

Siguiente paso

Integra facturacion con AI