Servidor MCP
Usa API SUNAT desde Claude, ChatGPT, Cursor, Codex o VS Code: conector remoto con OAuth o servidor local apisunat-mcp.
El servidor MCP apisunat-mcp conecta tu agente de IA con API SUNAT: emite y consulta comprobantes, anula, emite guías de remisión y explica los códigos de error de SUNAT. Es gratuito y de código abierto (MIT).
Puedes usarlo de dos formas: como conector remoto (sin instalar nada ni copiar claves) o instalado en tu equipo con una clave de API.
Conector remoto (recomendado)
Agrega esta URL como conector MCP en tu asistente:
Al conectar se abre API SUNAT: inicias sesión, eliges la empresa y el entorno:
- Pruebas: emite en SUNAT beta, sin validez tributaria y sin consumir tu plan.
- Producción: emite comprobantes reales. Se habilita cuando la empresa tiene registrados su usuario SOL y su certificado digital.
La conexión tiene acceso total en el entorno elegido y usa su propia clave de API, que verás en API Keys; en la página Conectores de la consola ves las conexiones activas y las desconectas. Para cambiar de entorno, desconéctala y vuelve a conectar.
En claude.ai o Claude Desktop: Configuración → Conectores → Agregar conector personalizado y pega la URL.
Instalación local (con clave de API)
Necesitas Node.js 18 o superior y una clave de API. Con una clave asu_test_ emites en SUNAT beta sin consumir tu plan. Ver Autenticación.
Herramientas
| Herramienta | Endpoint | Qué hace |
|---|---|---|
issue_document | POST /documents | Emite factura, boleta, nota de crédito o débito y retención |
get_document | GET /documents/{id} | Consulta un comprobante y su estado |
list_documents | GET /documents | Lista comprobantes por tipo, estado y fechas |
resend_document | POST /documents/{id}/resend | Reenvía a SUNAT un comprobante en error |
query_sunat_status | POST /documents/{id}/query-sunat | Consulta el ticket en SUNAT |
send_document_email | POST /documents/{id}/emails | Envía el PDF y el XML por correo |
void_documents | POST /voids | Anula comprobantes |
issue_guide / get_guide | POST /guides, GET /guides/{id} | Guías de remisión remitente |
calculate_totals | POST /calculations | Calcula totales e IGV sin emitir |
get_account | GET /account | Plan y consumo del mes |
list_issuers | GET /issuers | RUC registrados |
get_catalog / search_sunat_products | GET /catalogs/... | Catálogos de SUNAT |
explain_sunat_error | sin llamada | Explica un código de error de SUNAT; funciona sin clave |
issue_document, issue_guide y void_documents piden idempotency_key: usa un id estable de la venta. Si el agente repite la llamada, la API devuelve el mismo resultado. Ver Idempotencia.
Variables de entorno
| Variable | Descripción |
|---|---|
APISUNAT_API_KEY | Clave asu_test_ o asu_live_. Sin ella solo funciona explain_sunat_error. |
APISUNAT_BASE_URL | Opcional. Por defecto https://api.apisunat.net/api/v1/issuer. |
Skill o MCP
El servidor MCP sirve para que el agente opere la API: emitir, consultar o anular desde la conversación. Si quieres que el agente escriba la integración en tu propio sistema, usa el skill de la integración con IA. Puedes usar los dos.
