MCP server para VeriFactu (AEAT). Facturación electrónica española desde Claude Code.
Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
💡 Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
Servidor MCP para integrar VeriFactu (AEAT) con Claude Code y Cursor.
Permite generar, encadenar y enviar registros de facturación electrónica desde lenguaje natural, sin necesidad de leer la documentación técnica de la AEAT.
| Herramienta | Descripción |
|---|---|
generate_invoice_xml | Genera XML válido con hash SHA-256 encadenado (sin enviar) |
send_invoice | Envía registro de alta a la AEAT via API y persiste la huella |
cancel_invoice | Envía registro de anulación |
check_invoice_status | Consulta el estado de un registro |
list_invoices | Lista los registros enviados (filtros opcionales por emisor y paginación) |
get_last_hash | Devuelve la última huella registrada localmente para un emisor |
calculate_hash | Calcula el hash SHA-256 de cualquier registro |
El encadenamiento real lo gestiona la API verifactuapi.es internamente (vía
previous_id). El servidor MCP persiste la huella canónica que devuelve la
API en SQLite local (~/.verifactu-mcp/state.db) como audit log, no como
mecanismo de encadenamiento operativo. La herramienta get_last_hash consulta
ese log.
calculate_hash y la huella huella_local_estimada de send_invoice son
estimaciones heurísticas para inspección — la huella canónica AEAT incluye
el timestamp server-side y solo el servidor puede generarla.
Ejecuta list_invoices + send_invoice (¡emite registro real en sandbox!) +
check_invoice_status + get_last_hash. NO ejecutar contra producción.
Tras pip install -e ., el script verifactu-mcp queda disponible globalmente.
Añade esto a tu ~/.claude.json (o claude_desktop_config.json):
Alternativa sin script instalado (vía python -m):
| Variable | Descripción | Requerida |
|---|---|---|
VERIFACTU_API_TOKEN | Token de acceso a verifactuapi.es | Sí (para enviar) |
VERIFACTU_API_BASE | URL base de la API (por defecto producción) | No |
VERIFACTU_STATE_DB | Ruta a la DB SQLite de estado (por defecto ~/.verifactu-mcp/state.db) | No |
| Entorno | URL |
|---|---|
| Sandbox | https://prewww1.aeat.es/wlpl/TIKE-CONT/ws/SistemaFacturacion/VerifactuSOAP |
| Producción | https://www1.aeat.es/wlpl/TIKE-CONT/ws/SistemaFacturacion/VerifactuSOAP |
Para certificados de prueba (sandbox): catentidades@correo.aeat.es
MIT
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
[](https://allmcps.com/mcp/verifactu-mcp)<a href="https://allmcps.com/mcp/verifactu-mcp"><img src="https://allmcps.com/api/badge/verifactu-mcp?style=directory" alt="Verifactu Mcp on AllMCPs" /></a>