BillingEngine MCP

Crea facturas y clientes y registra pagos en BillingEngine desde Claude, Cursor y cualquier cliente MCP.

Documentación

Servidor MCP de BillingEngine

Crea clientes y facturas, consulta facturas abiertas y registra pagos en BillingEngine hablando con Claude, Cursor o cualquier otro cliente MCP:

"Crea una factura para Acme Painting por más de 100 euros."

"¿Qué facturas están vencidas?"

"Acme pagó la factura 2610030028, registra el pago."

BillingEngine es un software de facturación para autónomos y pequeñas empresas con facturación electrónica (EN 16931, XRechnung, ZUGFeRD / Factur-X). El servidor es una capa ligera sobre la API de BillingEngine y se ejecuta en tu ordenador.

Requisitos

Node.js 20 o superior
Una cuenta de BillingEngine en un plan de pago. La API no está disponible en el plan gratuito.
Tu clave de API desde Configuración > API en BillingEngine

Configuración

Claude Desktop

Añade esto 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

Usa los mismos command, args y env que arriba en la configuración de MCP de tu cliente.

Herramientas

Herramienta	Qué hace
`find_customers`	Busca clientes por empresa, nombre o correo electrónico
`create_customer`	Crea un cliente
`update_customer`	Modifica un cliente
`create_invoice`	Crea una factura borrador para un cliente
`update_invoice`	Modifica una factura borrador
`list_invoices`	Lista facturas, filtradas por estado, cliente, número o fecha
`get_invoice`	Devuelve una factura con sus partidas y estado de pago
`download_invoice`	Guarda el PDF o la factura electrónica XML en tu carpeta de Descargas
`record_payment`	Registra un pago para facturas enviadas
`list_payments`	Lista pagos, opcionalmente para una factura

Qué hace y qué no hace

Las facturas se crean como borradores. No se envía nada a tus clientes; tú revisas y envías la factura en BillingEngine. Cada resultado contiene un enlace para abrir el borrador.
Los precios son netos. Número, idioma, textos, tratamiento de IVA y condiciones de pago provienen de la configuración de tu cuenta, exactamente como en el formulario de factura.
Nada se puede eliminar a través de este servidor.
Las facturas nuevas cuentan para el máximo mensual de facturas de tu plan.
La API permite 60 solicitudes por minuto por clave.
Tu clave permanece en tu ordenador y solo se envía a BillingEngine.

Si una clave se expone alguna vez, genera una nueva en Configuración > API. La clave antigua deja de funcionar inmediatamente. La configuración también muestra cuándo se usó la clave por última vez.

Configuración

Variable	Significado
`BILLINGENGINE_API_KEY`	Tu clave de API (obligatoria)
`BILLINGENGINE_URL`	URL base, por defecto `https://www.billingengine.com`

Desarrollo

npm install
npm run build
BILLINGENGINE_API_KEY=... node dist/index.js

Licencia

MIT. BillingEngine en sí es un servicio comercial; consulta billingengine.com.