BillingEngine MCP

Crea facturas y clientes y registra pagos en BillingEngine desde cualquier cliente MCP. Las facturas se crean como borradores y nada puede eliminarse.

Documentación

Lo que puedes hacer

El servidor MCP de BillingEngine conecta asistentes de IA como Claude o Cursor a tu cuenta. Tú dices lo que necesitas, el asistente lo hace con tus datos de BillingEngine:

  • Crea una factura para Malermeister Müller por 100 euros.
  • ¿Qué facturas están vencidas?
  • Müller pagó la factura 2610030028, registra el pago.

Configuración

Necesitas Node.js 20 o superior, una cuenta de BillingEngine en un plan de pago y tu clave API desde Configuración > API.

Claude Desktop: añade el servidor a claude_desktop_config.json.

{
  "mcpServers": {
    "billingengine": {
      "command": "npx",
      "args": ["-y", "billingengine-mcp"],
      "env": { "BILLINGENGINE_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Claude Code:

claude mcp add billingengine \
  --env BILLINGENGINE_API_KEY=YOUR_API_KEY \
  -- npx -y billingengine-mcp

Cursor y otros clientes MCP: usa el mismo comando, argumentos y variable de entorno en la configuración del cliente.

El código fuente es abierto (licencia MIT) en GitHub.

Herramientas

HerramientaDescripción
find_customersBusca clientes por empresa, nombre o correo electrónico
create_customerCrea un cliente
update_customerModifica un cliente
create_invoiceCrea un borrador de factura para un cliente
update_invoiceModifica un borrador de factura
list_invoicesLista facturas, filtradas por estado, cliente, número o fecha
get_invoiceDevuelve una factura con sus partidas y estado de pago
download_invoiceGuarda el PDF o la factura electrónica XML de una factura en tu ordenador
record_paymentRegistra un pago para facturas enviadas
list_paymentsLista pagos, opcionalmente para una factura

Lo que el servidor no hace

  • Crea facturas como borradores. No se envía nada a tus clientes; tú revisas y envías cada factura en BillingEngine.
  • No puede eliminar nada.
  • Se ejecuta en tu ordenador y se comunica con BillingEngine solo con tu clave API. Puedes reemplazar la clave en tu configuración en cualquier momento; la configuración también muestra cuándo se usó por última vez.
  • Las facturas nuevas cuentan para el máximo mensual de facturas de tu plan, y la API permite 60 solicitudes por minuto por clave.