ArcaMCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| AFIP_CUIT | No | CUIT del contribuyente (obligatorio) | |
| AFIP_PASSWORD | No | contraseña asociada para automatizaciones (obligatorio) | |
| AFIP_CERT_ALIAS | No | alias que usarán las automatizaciones de certificados (obligatorio) | |
| AFIP_PRODUCTION | No | true para producción, false para homologación/dev (obligatorio) | |
| AFIP_DEV_KEY_PATH | No | ruta al .key de desarrollo (obligatorio) | |
| AFIP_DEV_CERT_PATH | No | ruta al certificado .crt de desarrollo (obligatorio) | |
| AFIP_PROD_KEY_PATH | No | ruta al .key de producción (obligatorio) | |
| AFIP_PROD_CERT_PATH | No | ruta al certificado .crt de producción (obligatorio) | |
| AFIP_SDK_ACCESS_TOKEN | No | token de acceso de la SDK (obligatorio en producción) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| completions | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_last_voucherC | Obtener número último comprobante creado |
| create_voucherC | Crear un comprobante electrónico en AFIP con CAE asignado |
| create_next_voucherA | Crear el próximo comprobante electrónico en AFIP con numeración automática y CAE asignado. Instrucciones para el asistente: Antes de ejecutar esta herramienta, entiende y valida exhaustivamente todos los parámetros requeridos según el tipo de comprobante a emitir (concepto, tipo de factura, moneda, punto de venta, importes, fechas, ítems, etc.). Si falta información o hay inconsistencias, solicita explícitamente los datos faltantes al usuario. Recomendación clave: previo a usar esta herramienta, consulta los puntos de venta disponibles del usuario y asegúrate de recibir el número de punto de venta correcto (PtoVta). Flujo sugerido: 1) Validar parámetros y completar faltantes preguntando al usuario. 2) Sugerir y/o consultar puntos de venta disponibles si no se proporcionó PtoVta. 3) Preparar y presentar un resumen claro y completo de la factura que se generará (todos los campos relevantes, importes y fechas). 4) Solicitar confirmación explícita del usuario. 5) Recién entonces proceder a crear el comprobante. Atención: Mantente atento a cualquier notificación, instrucción adicional o preferencia que el usuario indique durante el proceso y ajústalo antes de ejecutar la herramienta. |
| get_voucher_infoB | Obtener información completa de un comprobante ya emitido en AFIP |
| get_taxpayer_detailsC | Obtiene los datos completos de un contribuyente a partir de su CUIT |
| get_cuit_from_dniC | Obtiene el CUIT de un contribuyente a partir de su DNI |
| create_pdfA | Genera un PDF dinámico de un comprobante electrónico combinando datos del voucher, emisor y receptor desde AFIP. La manera más recomendada de llenar la información para la factura de manera correcta es utilizar las herramientas apropiadas para recuperar los datos del CAE y los datos tanto del emisor como del receptor utilizando sus CUIT. El LLM no debe asumir ninguna información que no haya sido dada explícitamente o que no pueda inferir. Una vez todos los datos estén recopilados, se debe hacer un resumen de la factura tal cual como quedaría y mostrársela al usuario antes de proceder. Procederemos solo cuando tengamos la confirmación explícita del usuario. Si A13 devuelve varios domicilios elegibles de igual prioridad, reintentar con DIRECCION_EMISOR_SELECCIONADA usando uno de los candidatos devueltos. Este campo se valida contra A13 y no permite direcciones arbitrarias. Nota importante: este tool usa dos campos relacionados al tipo de comprobante para evitar ambigüedad: CbteTipo (código numérico AFIP para uso técnico/QR) y CbteLetra (A/B/C/M) únicamente para la visualización en el PDF. |
| get_sales_pointsA | Obtiene los puntos de venta disponibles para facturación electrónica. En testing siempre devuelve error ya que no existen puntos de venta configurados (se usa punto de venta 1 por defecto). |
| get_voucher_typesB | Obtiene los tipos de comprobantes disponibles en AFIP (Factura A, B, C, Nota de Crédito, etc.). |
| get_concept_typesA | Obtiene los tipos de conceptos disponibles en AFIP (Productos, Servicios, Productos y Servicios). |
| get_document_typesA | Obtiene los tipos de documentos disponibles en AFIP (DNI, CUIT, CUIL, Pasaporte, etc.). |
| get_aliquot_typesA | Obtiene los tipos de alícuotas de IVA disponibles en AFIP (0%, 10.5%, 21%, 27%, etc.). |
| get_currencies_typesA | Obtiene los tipos de monedas disponibles en AFIP (ARS, USD, EUR, etc.). |
| get_exchange_rateB | Obtiene la cotización de una moneda específica para una fecha determinada desde AFIP. |
| get_options_typesC | Obtiene los tipos de opciones disponibles para los comprobantes en AFIP. |
| get_tax_typesA | Obtiene los tipos de tributos disponibles en AFIP (IIBB, impuestos municipales, etc.). |
| get_tax_condition_typesA | Obtiene los tipos de condiciones frente al IVA disponibles en AFIP (Responsable Inscripto, Monotributista, Exento, etc.). |
| mis_comprobantesA | Inicia la automatización 'Mis Comprobantes' de ARCA para descargar comprobantes emitidos o recibidos por un CUIT. Este tool SIEMPRE ejecuta en modo asíncrono (wait=false) y devuelve sólo { id, status }. Para consultar el resultado final, usar el tool 'get_automation_details' con el id devuelto. Las credenciales (CUIT, username y password) se leen de la configuración. |
| get_automation_detailsA | Consulta el estado o el resultado final de una automatización previamente iniciada (p. ej., 'mis_comprobantes') usando su ID. Este tool SIEMPRE consulta en modo no bloqueante (wait=false). Si la automatización sigue en proceso, devolverá { id, status: 'in_process' }. Cuando finalice, devolverá los datos completos. |
| get_certificate_statusA | Returns the loaded X.509 certificate validity status without exposing certificate, key, identity, issuer, subject, or local paths. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| wizard_crear_comprobante | Guía interactiva para reunir y validar los datos requeridos para crear un comprobante en AFIP (create_next_voucher o create_voucher). El asistente debe: (1) completar faltantes usando tools, (2) validar coherencia (productos vs servicios), (3) presentar un resumen y solicitar confirmación explícita, (4) ejecutar la tool correspondiente y (5) devolver un resumen del resultado. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 20 tools
Most tools target distinct resources or actions, and the many get_*_types catalog lookups are clearly separated by their respective AFIP type. The main overlap is create_voucher vs create_next_voucher, which both mint a voucher and differ only in explicit vs auto numbering, which could cause misselection without reading carefully.
The set follows a clean get_*/create_* verb_noun snake_case pattern throughout. The main deviation is 'mis_comprobantes', a Spanish, verbless name that breaks the otherwise consistent English convention (though get_currencies_types has a minor plural awkwardness).
At 20 tools the set is on the heavy side but each catalog lookup (concepts, document types, aliquots, taxes, etc.) maps to a genuine AFIP data domain, so most tools earn their place. The many independent get_*_types tools could in principle be consolidated, keeping it slightly above ideal.
The surface covers voucher creation (explicit and auto-numbered), retrieval, PDF generation, taxpayer lookup, certificate status, and full AFIP catalog discovery, plus an async automation for downloading comprobantes. The main gaps are no voucher listing/history or void/credit-note lifecycle beyond the generic create path, but core invoicing workflows are covered.