MCP Invoice Express

InvoiceExpress MCP - Gestión Completa de Facturas Portuguesas para IA

❌ Sin InvoiceExpress MCP

Gestionar facturas portuguesas con IA se vuelve frustrante y propenso a errores:

• ❌ Creación manual de facturas con ejemplos de API desactualizados
• ❌ Sin automatización de cumplimiento SAF-T para informes fiscales portugueses
• ❌ Faltan cálculos y validaciones de impuestos portugueses
• ❌ Sin integración con los sistemas de la Autoridade Tributária (AT)
• ❌ Gestión compleja de tesorería y saldos de clientes

✅ Con InvoiceExpress MCP

InvoiceExpress MCP proporciona gestión completa de facturas portuguesas con más de 60 herramientas especializadas:

Añade Create an invoice for client "Tech Solutions" with Portuguese tax compliance a tu prompt en Cursor:

Create an invoice for client "Tech Solutions Ltd" with VAT 23% and generate SAF-T for tax authority submission

Export monthly SAF-T file for January 2024 and update client payment status

InvoiceExpress MCP ofrece:

• ✅ Más de 60 Herramientas Especializadas: Gestión completa de facturas, clientes y tesorería
• ✅ Cumplimiento Fiscal Portugués: Generación automática de SAF-T, integración con AT
• ✅ Soporte Multi-Documento: Facturas, presupuestos, guías, movimientos de tesorería
• ✅ Nivel Empresarial: TypeScript, manejo de errores, arquitectura limpia
• ✅ Formatos de Fecha Portugueses: Conversión automática DD/MM/AAAA

🚀 Conjunto Completo de Funciones

📧 Gestión de Facturas (11 herramientas)

• Crear, actualizar y gestionar facturas con cumplimiento fiscal portugués
• Generar PDFs, códigos QR y envío por correo electrónico
• Manejar pagos, reembolsos y estados de documentos
• Soporte para todos los tipos de facturas portuguesas (simplificadas, recibos, notas de crédito)

👥 Gestión de Clientes (7 herramientas)

• Base de datos completa de clientes con información fiscal portuguesa
• Búsqueda por nombre, código o NIF
• Seguimiento de facturas e historial de pagos de clientes
• Gestión de direcciones y contactos

📋 Presupuestos y Cotizaciones (7 herramientas)

• Cotizaciones profesionales, proformas y notas de honorarios
• Conversión de presupuestos a facturas sin problemas
• Generación de PDF y envío por correo electrónico
• Flujo de trabajo de gestión de estados

🚚 Transporte y Envíos (8 herramientas)

• Guías de envío, documentos de transporte, notas de devolución
• Generación de códigos QR para seguimiento
• Integración con requisitos logísticos portugueses
• Automatización del flujo de trabajo de documentos

📦 Catálogo de Productos (5 herramientas)

• Gestión completa de productos y servicios
• Asignación de tipos de impuestos y precios
• Integración de seguimiento de inventario
• Soporte de códigos fiscales portugueses

🔢 Secuencias de Documentos (5 herramientas)

• Numeración legal de documentos portugueses
• Registro en la Autoridade Tributária (AT)
• Gestión de códigos de validación
• Cumplimiento con la legislación portuguesa

💰 Gestión de Impuestos (5 herramientas)

• Tipos de IVA portugueses (IVA 6%, 13%, 23%)
• Soporte de impuestos regionales (Açores, Madeira)
• Configuración personalizada de impuestos
• Cálculos automáticos de impuestos

🏢 Gestión de Cuentas (5 herramientas)

• Soporte multi-cuenta para agencias
• Configuración de comunicación con AT
• Gestión de usuarios y permisos
• Creación de cuentas para usuarios existentes

📊 Cumplimiento SAF-T (1 herramienta)

• Generación mensual de archivos SAF-T para la autoridad fiscal portuguesa
• Plazos automáticos de presentación (día 5 de cada mes)
• Cumplimiento del formato XML con requisitos de AT
• Mantenimiento de pista de auditoría

💳 Operaciones de Tesorería (7 herramientas)

• Gestión y seguimiento de saldos de clientes
• Registro de pagos y reembolsos
• Regularizaciones financieras
• Historial de movimientos de tesorería

🛠️ Instalación

Requisitos

• Node.js >= v18.0.0
• Cuenta de InvoiceExpress con acceso a API
• Cursor, Claude Desktop, VS Code u otro Cliente MCP

npx -y @smithery/cli@latest install @wizardingcode/invoiceexpress-mcp --client <CLIENT_NAME> --key <YOUR_SMITHERY_KEY>

{
  "mcpServers": {
    "invoiceexpress": {
      "command": "npx",
      "args": ["-y", "@wizardingcode/invoiceexpress-mcp@latest"],
      "env": {
        "INVOICEEXPRESS_API_KEY": "your-api-key",
        "INVOICEEXPRESS_ACCOUNT_NAME": "your-account-name"
      }
    }
  }
}

{
  "mcpServers": {
    "invoiceexpress": {
      "command": "bunx",
      "args": ["-y", "@wizardingcode/invoiceexpress-mcp@latest"],
      "env": {
        "INVOICEEXPRESS_API_KEY": "your-api-key",
        "INVOICEEXPRESS_ACCOUNT_NAME": "your-account-name"
      }
    }
  }
}

{
  "mcpServers": {
    "invoiceexpress": {
      "command": "deno",
      "args": ["run", "--allow-env=INVOICEEXPRESS_API_KEY,INVOICEEXPRESS_ACCOUNT_NAME,NO_DEPRECATION,TRACE_DEPRECATION", "--allow-net", "npm:@wizardingcode/invoiceexpress-mcp"],
      "env": {
        "INVOICEEXPRESS_API_KEY": "your-api-key",
        "INVOICEEXPRESS_ACCOUNT_NAME": "your-account-name"
      }
    }
  }
}

"mcp": {
  "servers": {
    "invoiceexpress": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@wizardingcode/invoiceexpress-mcp@latest"],
      "env": {
        "INVOICEEXPRESS_API_KEY": "your-api-key",
        "INVOICEEXPRESS_ACCOUNT_NAME": "your-account-name"
      }
    }
  }
}

{
  "mcpServers": {
    "InvoiceExpress": {
      "command": "npx",
      "args": ["-y", "@wizardingcode/invoiceexpress-mcp@latest"],
      "env": {
        "INVOICEEXPRESS_API_KEY": "your-api-key",
        "INVOICEEXPRESS_ACCOUNT_NAME": "your-account-name"
      }
    }
  }
}

{
  "mcpServers": {
    "invoiceexpress": {
      "command": "npx",
      "args": ["-y", "@wizardingcode/invoiceexpress-mcp@latest"],
      "env": {
        "INVOICEEXPRESS_API_KEY": "your-api-key",
        "INVOICEEXPRESS_ACCOUNT_NAME": "your-account-name"
      }
    }
  }
}

{
  "context_servers": {
    "InvoiceExpress": {
      "command": {
        "path": "npx",
        "args": ["-y", "@wizardingcode/invoiceexpress-mcp@latest"]
      },
      "settings": {
        "INVOICEEXPRESS_API_KEY": "your-api-key",
        "INVOICEEXPRESS_ACCOUNT_NAME": "your-account-name"
      }
    }
  }
}

{
  "mcpServers": {
    "invoiceexpress": {
      "command": "npx",
      "args": ["-y", "@wizardingcode/invoiceexpress-mcp@latest"],
      "env": {
        "INVOICEEXPRESS_API_KEY": "your-api-key",
        "INVOICEEXPRESS_ACCOUNT_NAME": "your-account-name"
      }
    }
  }
}

{
  "mcpServers": {
    "invoiceexpress": {
      "command": "npx",
      "args": ["-y", "@wizardingcode/invoiceexpress-mcp@latest"],
      "env": {
        "INVOICEEXPRESS_API_KEY": "your-api-key",
        "INVOICEEXPRESS_ACCOUNT_NAME": "your-account-name"
      }
    }
  }
}

FROM node:18-alpine

WORKDIR /app

# Install the latest version globally
RUN npm install -g @wizardingcode/invoiceexpress-mcp

# Set environment variables
ENV INVOICEEXPRESS_API_KEY=your-api-key
ENV INVOICEEXPRESS_ACCOUNT_NAME=your-account-name

# Default command to run the server
CMD ["invoiceexpress-mcp"]

docker build -t invoiceexpress-mcp .

{
  "mcpServers": {
    "invoiceexpress": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@wizardingcode/invoiceexpress-mcp@latest"],
      "disabled": false,
      "env": {
        "INVOICEEXPRESS_API_KEY": "your-api-key",
        "INVOICEEXPRESS_ACCOUNT_NAME": "your-account-name"
      }
    }
  }
}

🔧 Configuración

Variables de Entorno Requeridas

INVOICEEXPRESS_API_KEY=your-api-key-here
INVOICEEXPRESS_ACCOUNT_NAME=your-account-name

Variables de Entorno Opcionales

MCP_MODE=silent  # Reduces logging output for production

Obtener tus Credenciales de InvoiceExpress

1. Inicia sesión en tu cuenta de InvoiceExpress
2. Ve a Configuración > Acceso a API
3. Genera o copia tu clave de API
4. Anota el nombre de tu cuenta (subdominio en tu URL de InvoiceExpress)

🔨 Herramientas Disponibles (60+)

InvoiceExpress MCP proporciona más de 60 herramientas especializadas organizadas por área de funcionalidad:

📧 Gestión de Facturas (11 herramientas)

• invoice_list - Listar facturas con filtrado avanzado (estado, fecha, cliente, importe)
• invoice_create - Crear facturas con cumplimiento fiscal portugués
• invoice_get - Obtener información detallada de facturas
• invoice_update - Actualizar facturas existentes
• invoice_send_email - Enviar facturas por correo electrónico con mensajes personalizables
• invoice_generate_pdf - Generar documentos PDF
• invoice_change_state - Cambiar estados de facturas (borrador, enviada, final, cancelada)
• invoice_get_related_documents - Obtener documentos relacionados (notas de crédito, recibos)
• invoice_generate_payment - Generar referencias de pago (MB, CC, PayPal)
• invoice_cancel_payment - Cancelar referencias de pago
• invoice_get_qrcode - Generar códigos QR para pagos digitales

👥 Gestión de Clientes (7 herramientas)

• client_list - Listar todos los clientes con paginación y filtrado
• client_create - Crear nuevos clientes con información fiscal portuguesa
• client_get - Obtener información detallada del cliente
• client_update - Actualizar información y configuración del cliente
• client_find_by_name - Buscar clientes por nombre o coincidencia parcial
• client_find_by_code - Encontrar clientes por código único
• client_list_invoices - Listar todas las facturas de un cliente específico

📋 Presupuestos y Cotizaciones (7 herramientas)

• estimate_list - Listar presupuestos, cotizaciones, proformas y notas de honorarios
• estimate_create - Crear presupuestos y cotizaciones profesionales
• estimate_get - Obtener información detallada del presupuesto
• estimate_update - Actualizar presupuestos existentes
• estimate_send_email - Enviar presupuestos por correo electrónico
• estimate_generate_pdf - Generar documentos PDF
• estimate_change_state - Gestionar estados del flujo de trabajo de presupuestos

🚚 Guías y Transporte (8 herramientas)

• guide_list - Listar guías de envío, documentos de transporte, notas de devolución
• guide_create - Crear documentación de envío y transporte
• guide_get - Obtener información detallada de la guía
• guide_update - Actualizar documentación de transporte
• guide_send_email - Enviar guías por correo electrónico
• guide_generate_pdf - Generar documentos PDF de transporte
• guide_change_state - Gestionar estados del flujo de trabajo de guías
• guide_get_qrcode - Generar códigos QR para seguimiento

📦 Catálogo de Productos (5 herramientas)

• item_list - Listar productos y servicios con filtrado
• item_create - Crear nuevos productos/servicios con información fiscal
• item_get - Obtener información detallada del artículo
• item_update - Actualizar información de productos/servicios
• item_delete - Eliminar artículos del catálogo

🔢 Secuencias de Documentos (5 herramientas)

• sequence_list - Listar todas las secuencias de numeración de documentos
• sequence_get - Obtener información detallada de la secuencia
• sequence_create - Crear nuevas secuencias de documentos
• sequence_set_as_current - Establecer secuencia de documentos predeterminada
• sequence_register - Registrar secuencias con la Autoridad Tributaria Portuguesa (AT)

💰 Gestión de Impuestos (5 herramientas)

• tax_list - Listar todos los tipos de impuestos configurados
• tax_create - Crear nuevos tipos de impuestos (IVA, impuestos regionales)
• tax_get - Obtener información detallada de impuestos
• tax_update - Actualizar configuraciones de tipos de impuestos
• tax_delete - Eliminar tipos de impuestos no utilizados

🏢 Gestión de Cuentas (5 herramientas)

• account_get - Obtener información y configuración de la cuenta
• account_create - Crear nuevas cuentas de InvoiceExpress
• account_update - Actualizar configuración e información de la cuenta
• account_create_for_existing_user - Crear cuentas adicionales para usuarios existentes
• account_update_at_communication - Configurar comunicación con la Autoridad Tributaria (AT)

📊 Cumplimiento Fiscal SAF-T (1 herramienta)

• saft_export - Exportar archivos SAF-T mensuales para presentación a la autoridad fiscal portuguesa

💳 Operaciones de Tesorería (7 herramientas)

• treasury_get_client_balance - Obtener saldo financiero y estado del cliente
• treasury_update_client_initial_balance - Establecer o actualizar saldos iniciales de clientes
• treasury_get_regularizations - Listar regularizaciones financieras
• treasury_create_regularization - Crear regularizaciones de saldo
• treasury_delete_regularization - Eliminar regularizaciones
• treasury_create_movement - Registrar pagos y reembolsos
• treasury_delete_movement - Eliminar movimientos de tesorería

💡 Ejemplos de Uso

Crear una Factura Completa

Create an invoice for client "Tech Solutions Ltd" with the following:
- Service: Web Development (40 hours × €75/hour)
- Product: Hosting Setup (1 × €200)
- Apply IVA 23% to all items
- Due date: 30 days from today
- Generate PDF and send by email

Cumplimiento Fiscal Portugués

Generate SAF-T file for January 2024 for tax authority submission.
The file must be ready by February 5th deadline.

Gestión de Saldo de Clientes

Update client "ABC Company" initial balance to €1,500 dated January 1st, 2024.
Create a payment record of €500 received via Multibanco on March 15th.

Flujo de Trabajo de Documentos

Create a quote for "New Project Proposal" for client XYZ Corp.
Convert the accepted quote to an invoice.
Generate shipping guide for product delivery.

🇵🇹 Funciones Fiscales Portuguesas

Cumplimiento SAF-T

• Generación automática mensual de archivos SAF-T
• Cumplimiento del formato de la Autoridad Tributaria Portuguesa (AT)
• Recordatorios de plazos de presentación (día 5 de cada mes)
• Mantenimiento completo de pista de auditoría

Formatos de Fecha Portugueses

• Conversión automática entre formatos ISO (YYYY-MM-DD) y portugués (DD/MM/YYYY)
• Cumplimiento con los estándares empresariales portugueses
• Validación y formato de fechas adecuados

Integración con la Autoridad Tributaria

• Configuración de comunicación con AT
• Registro de secuencia de documentos
• Gestión de códigos de validación
• Cumplimiento con la legislación portuguesa

Soporte de IVA Portugués

• Tipos estándar: IVA 6%, 13%, 23%
• Tipos regionales para Azores y Madeira
• Cálculos automáticos de impuestos
• Gestión de exenciones fiscales

🚨 Solución de problemas

# Test your credentials
INVOICEEXPRESS_API_KEY=your-key INVOICEEXPRESS_ACCOUNT_NAME=your-account invoiceexpress-mcp --help

{
  "mcpServers": {
    "invoiceexpress": {
      "command": "bunx",
      "args": ["-y", "@wizardingcode/invoiceexpress-mcp@latest"]
    }
  }
}

💻 Desarrollo

Clone el proyecto e instale las dependencias:

git clone https://github.com/andreagroferreira/invoiceexpress-mcp.git
cd invoiceexpress-mcp
npm install

Compilar:

npm run build

Ejecute el servidor:

npm start

Argumentos de CLI

invoiceexpress-mcp acepta las siguientes banderas de CLI:

• --transport <stdio|http|sse> – Transporte a utilizar (stdio por defecto)
• --port <number> – Puerto para escuchar cuando se usa el transporte http o sse (por defecto 3000)
• --help, -h – Mostrar mensaje de ayuda

Ejemplo con ayuda:

invoiceexpress-mcp --help

npx -y @modelcontextprotocol/inspector npx @wizardingcode/invoiceexpress-mcp

📄 Licencia

Licencia MIT - consulte el archivo LICENCIA para más detalles.

🤝 Acerca de WizardingCode.io

InvoiceExpress MCP es desarrollado y mantenido por WizardingCode.io, especializado en soluciones de automatización empresarial impulsadas por IA para empresas portuguesas.

Conéctese con nosotros

• 🌐 Sitio web: wizardingcode.io
• 📧 Correo electrónico: andreagroferreira.af@gmail.com
• 💼 LinkedIn: WizardingCode

Soporte

Para soporte técnico, solicitudes de funciones o consultas comerciales:

1. 🐛 Reporte problemas en GitHub
2. 📧 Envíenos un correo a andreagroferreira.af@gmail.com
3. 💬 Soporte profesional disponible para clientes empresariales

Hecho con ❤️ en Portugal para empresas portuguesas que usan IA