ArcaMCP
Summary: ArcaMCP is an MCP server for Argentina's AFIP/ARCA that automates electronic invoicing (CAE issuance) and taxpayer/padrón lookups.
Emit invoices: create vouchers with manual or automatic numbering (
create_voucher,create_next_voucher) and get CAE + expiry.Query issued invoices: fetch last voucher number (
get_last_voucher) and full details of an emitted voucher (get_voucher_info).Taxpayer data: look up taxpayer details by CUIT (
get_taxpayer_details) and derive CUIT from DNI (get_cuit_from_dni).AFIP catalogs: sales points, voucher types, concepts, document types, IVA aliquots, currencies, exchange rates, optional fields, taxes, and IVA conditions.
Generate invoice PDFs:
create_pdfbuilds a PDF (with AFIP QR) from voucher/issuer/receiver data, returning a link valid 24 hours.List vouchers (Mis Comprobantes): start an async ARCA automation (
mis_comprobantes) and poll results withget_automation_details.Certificate health:
get_certificate_statusreports environment, validity dates, days remaining, and status without exposing keys or paths.Safety annotations: destructive/irreversible emission tools are flagged for user confirmation; all queries are read-only.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ArcaMCP generate an electronic invoice for $10,000"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ARCA MCP (Model Context Protocol) para AFIP/ARCA
Este proyecto implementa un servidor MCP (Model Context Protocol) orientado a integrarse con AFIP (Argentina) y automatizar tareas claves del flujo de facturación electrónica y consulta de padrones. Aprovecha la SDK oficial de AFIP (@afipsdk/afip.js) y automatizaciones para:
Generar y gestionar certificados X.509 (dev y producción).
Autorizar Web Services (ej.
wsfe,ws_sr_padron_a13).Interactuar con servicios AFIP para emisión y consulta de comprobantes.
Estandarizar configuraciones, variables de entorno y rutas de certificados.
Además, el paquete incluye los comandos arcamcp setup y arcamcp doctor, que automatizan y diagnostican el onboarding en AFIP, reduciendo tiempos de configuración y posibles errores manuales.
Requisitos
Node.js 22 o superior (para desarrollar el proyecto se usa Node 26; ver
.node-version)pnpm (la versión canónica la define el campo
packageManagerdepackage.json)Acceso a tu CUIT y a tu cuenta de AFIP
Clave Fiscal nivel 3 o superior
(Opcional pero recomendado) Git para clonar el repositorio
Related MCP server: Invoicetronic MCP Server
Instalación rápida
No necesitás clonar el repositorio ni instalar el paquete globalmente. Con Node.js 22 o superior, Clave Fiscal nivel 3 y un access token de afipsdk.com:
# 1. Crear el certificado, autorizar wsfe y ws_sr_padron_a13 y generar .env
# (usá --prod para producción; pide por terminal lo que falte)
npx -y @yoryoboy/arcamcp@latest setup --dev
# 2. Verificar que todo quedó bien (no modifica nada)
npx -y @yoryoboy/arcamcp@latest doctor
# 3. Iniciar el servidor MCP (normalmente lo hace tu cliente MCP)
npx -y @yoryoboy/arcamcp@latestsetup imprime al final el bloque JSON listo para pegar en tu cliente MCP. Si
preferís configurar todo a mano, mirá la sección
Configuración. El servidor también carga un archivo .env
desde el directorio donde ejecutás el comando. Detalle de los comandos en
Comandos de línea de comandos.
Para desarrollar el proyecto localmente:
Cloná el repositorio y entrá en su directorio.
Ejecutá
pnpm install.Ejecutá
pnpm run dev setup --devo creá el archivo.enva mano, y verificá conpnpm run dev doctor.Iniciá el servidor con
pnpm run devo el Inspector conpnpm run inspector.
Configuración (.env)
El archivo src/config.ts lee las siguientes variables de entorno:
AFIP_CUIT(obligatorio): CUIT del contribuyente.AFIP_PASSWORD(solo para automatizaciones): clave fiscal usada por las automatizaciones de certificados y autorización.AFIP_CERT_ALIAS(solo para automatizaciones): alias que usarán las automatizaciones de certificados.AFIP_DEV_CERT_PATH(obligatorio conAFIP_PRODUCTION=false): ruta absoluta o relativa al certificado.crtde desarrollo.AFIP_DEV_KEY_PATH(obligatorio conAFIP_PRODUCTION=false): ruta al.keyde desarrollo.AFIP_PROD_CERT_PATH(obligatorio conAFIP_PRODUCTION=true): ruta al certificado.crtde producción.AFIP_PROD_KEY_PATH(obligatorio conAFIP_PRODUCTION=true): ruta al.keyde producción.AFIP_PRODUCTION:truepara producción,falsepara homologación/dev.AFIP_SDK_ACCESS_TOKEN(obligatorio en producción): token de acceso de la SDK si corresponde.
Ejemplo de .env (plantilla):
# Identidad
AFIP_CUIT=20123456789
AFIP_PASSWORD=tu_password_afip
AFIP_CERT_ALIAS=mi-cert-prod
# Certificados (ajusta rutas según tu entorno)
AFIP_DEV_CERT_PATH=./certs/dev/dev_certificado.crt
AFIP_DEV_KEY_PATH=./certs/dev/dev_private.key
AFIP_PROD_CERT_PATH=./certs/prod/prod_certificado.crt
AFIP_PROD_KEY_PATH=./certs/prod/prod_private.key
# Modo
AFIP_PRODUCTION=false
# SDK (requerido cuando AFIP_PRODUCTION=true)
AFIP_SDK_ACCESS_TOKEN=Notas:
Verifica las rutas de certificados: el código los lee con
fs.readFileSync(...)ensrc/services/afip/client.ts.Si
AFIP_PRODUCTION=true, deben existirAFIP_PROD_CERT_PATH,AFIP_PROD_KEY_PATHy, si aplica,AFIP_SDK_ACCESS_TOKEN.
Estructura del proyecto
src/config.ts: carga.envy expone configuración.src/services/afip/client.ts: inicializa el cliente de@afipsdk/afip.jscon certificados y CUIT.src/index.ts: punto de entrada del binarcamcp(servidor MCP o comandossetup/doctor).src/server.ts: registra tools y prompts e inicia el servidor MCP por stdio.src/cli/: comandossetup(certificado + autorización de servicios +.env) ydoctor.certs/: carpeta sugerida para ubicar certificados (./certs/devy./certs/prod).
Pasos para usar el MCP (guía completa)
A continuación se detalla, punto por punto, el flujo recomendado. Puedes ejecutar estos pasos desde Windows PowerShell o CMD.
1) Obtener Clave Fiscal nivel 3
AFIP requiere Clave Fiscal 3 para operar con Web Services. Guía oficial:
Asegúrate de completar este paso antes de continuar.
2) Obtener API Key/Access Token de la SDK de AFIP
Este MCP utiliza automatizaciones provistas por la SDK de AFIP para simplificar tareas como: generación de certificados, autorización de servicios y recuperación de comprobantes.
Sitio: https://afipsdk.com/
Si tu flujo de automatización requiere AFIP_SDK_ACCESS_TOKEN, colócalo en .env para producción.
3) Obtener el certificado y autorizar los Web Services (automatizado)
Desde el directorio donde querés guardar los certificados y el .env, ejecutá:
# Homologación (por defecto si AFIP_PRODUCTION no es "true")
npx -y @yoryoboy/arcamcp@latest setup --dev
# Producción
npx -y @yoryoboy/arcamcp@latest setup --prodsetup:
Toma
AFIP_CUIT,AFIP_CERT_ALIAS,AFIP_SDK_ACCESS_TOKENyAFIP_PASSWORDdel entorno o de.env. Si falta alguno y estás en una terminal, lo pide; el token y la clave fiscal se piden sin eco.Crea el certificado con la automatización
create-cert-devocreate-cert-prody lo guarda en./certs/dev/o./certs/prod/(<env>_certificado.crty<env>_private.key, esta última con permisos600).Crea o actualiza
.envconAFIP_CUIT,AFIP_CERT_ALIAS,AFIP_SDK_ACCESS_TOKENy las rutas absolutasAFIP_<DEV|PROD>_CERT_PATH/AFIP_<DEV|PROD>_KEY_PATH, conservando el resto de las líneas. Solo agregaAFIP_PRODUCTIONsi no existe. La clave fiscal nunca se guarda.Autoriza
wsfeyws_sr_padron_a13conauth-web-service-devoauth-web-service-prod.Imprime el bloque JSON listo para pegar en la configuración de tu cliente MCP.
Si ya existe un certificado en ./certs/<env>/, setup no hace nada y termina con error antes de contactar a ARCA. Usá --force para crear uno nuevo y reemplazarlo.
Nota: el servidor carga
.envdesde su directorio de trabajo. Si tu cliente MCP lo inicia desde otro directorio, copiá las variables al bloqueenvdel cliente (el que imprimesetup).
4) Verificar la configuración
npx -y @yoryoboy/arcamcp@latest doctordoctor no modifica nada. Revisa las variables del ambiente activo, que los archivos de certificado y clave existan, que el certificado sea válido y no esté vencido, y que la clave corresponda al certificado. Si todo eso está bien, consulta a ARCA que wsfe esté autorizado y, en producción, también el padrón A13 y los puntos de venta. Termina con código 0 si no hay errores (✖) y 1 si los hay.
5) Dar de alta un Punto de Venta para Facturación Electrónica
Sigue esta guía (referencia externa) para dar de alta el PDV que usarás con wsfe:
Asegúrate de asociar correctamente el PDV al servicio de facturación electrónica.
Ejecución del servidor MCP
Uso con npx
Para ejecutar la versión publicada sin clonar el repositorio ni instalarla globalmente:
npx -y @yoryoboy/arcamcp@latest-y permite que npx descargue el paquete sin pedir confirmación, algo
necesario cuando un cliente MCP inicia el proceso sin una terminal interactiva.
El tag latest mantiene el cliente en la última versión estable publicada.
Configurá las variables de entorno requeridas antes de ejecutarlo. El servidor
carga .env desde el directorio de trabajo actual.
Ejemplo de configuración de un cliente MCP:
{
"arca-mcp": {
"command": "npx",
"args": ["-y", "@yoryoboy/arcamcp@latest"],
"env": {
"AFIP_CUIT": "20123456789",
"AFIP_PASSWORD": "tu_password_afip",
"AFIP_CERT_ALIAS": "mi-cert-prod",
"AFIP_DEV_CERT_PATH": "/ruta/local/dev.crt",
"AFIP_DEV_KEY_PATH": "/ruta/local/dev.key",
"AFIP_PROD_CERT_PATH": "/ruta/local/prod.crt",
"AFIP_PROD_KEY_PATH": "/ruta/local/prod.key",
"AFIP_PRODUCTION": "false",
"AFIP_SDK_ACCESS_TOKEN": ""
}
}
}No incluyas credenciales, tokens, certificados ni claves privadas en archivos del proyecto o en repositorios públicos.
Desarrollo:
pnpm run devEsto lanza
src/index.tscontsxen modo desarrollo.Inspector MCP (diagnóstico):
pnpm run inspectorUtiliza
@modelcontextprotocol/inspectorcontra la misma entrada (src/index.ts).
Estado del certificado X.509
La tool read-only get_certificate_status informa el ambiente, las fechas de
validez, los días restantes y el estado del certificado X.509 efectivamente
cargado por el cliente. No lee ni accede a la clave privada y no expone PEM,
identidad, subject, issuer ni rutas locales.
Las tools que usan WSAA/WSN se bloquean si el certificado todavía no es válido o ya venció. Si faltan exactamente 90 días o menos, continúan normalmente y se emite una advertencia visible una sola vez por proceso. La fecha se compara con un límite exacto de 90 días, no con meses calendario. Para inspeccionar las fechas manualmente, ejecuta:
openssl x509 -in /ruta/al/certificado.crt -noout -datesDespués de renovar o reemplazar el certificado, reinicia ArcaMCP para que el cliente cargue el nuevo PEM.
Confirmación de acciones (annotations MCP)
Cada tool declara annotations MCP para que el cliente sepa cuándo pedir confirmación:
create_voucherycreate_next_voucher:destructiveHint: true,idempotentHint: false. Emiten un comprobante fiscal con CAE, que es irreversible y no se debe repetir.create_pdf: no es de solo lectura (genera un archivo nuevo en cada llamada), pero no es destructiva.Todas las consultas (catálogos,
get_voucher_info,get_taxpayer_details,mis_comprobantes, etc.):readOnlyHint: true.get_certificate_status:readOnlyHint: true,openWorldHint: false(solo lee el certificado local).
Comandos de línea de comandos
arcamcp Inicia el servidor MCP por stdio.
arcamcp setup [--dev | --prod] [--force] Crea el certificado, actualiza .env y autoriza wsfe y ws_sr_padron_a13.
arcamcp doctor Diagnostica la configuración sin modificar nada.
arcamcp help Muestra la ayuda.Con npx, anteponé npx -y @yoryoboy/arcamcp@latest. Desde un clone del repositorio, usá pnpm run dev <comando> (por ejemplo pnpm run dev doctor). Un comando u opción desconocidos terminan con código 2.
Herramientas adicionales del MCP
Mis Comprobantes (asíncrono con consulta por ID)
La tool mis_comprobantes inicia la automatización "Mis Comprobantes" de ARCA para listar comprobantes emitidos/recibidos. Por diseño, se ejecuta en modo asíncrono (wait=false):
Entrada: filtros opcionales como
t,fechaEmision,puntosVenta,tiposComprobantes,comprobanteDesde,comprobanteHasta,tipoDoc,nroDoc,codigoAutorizacion.Salida inmediata: un objeto con
idystatus. No contiene todavía los datos finales; es el identificador de la ejecución.Consulta del resultado: usa posteriormente el tool
get_automation_detailscon eseidpara verificar si finalizó y recuperar los datos.
Ejemplo de uso conceptual (cliente MCP):
{
"tool": "mis_comprobantes",
"params": {
"t": "emitidos",
"fechaEmision": "2025-09-01..2025-09-22",
"puntosVenta": [1],
"tiposComprobantes": [11]
}
}Respuesta típica inicial:
{
"id": "abc123",
"status": "running"
}Luego, para consultar el resultado:
{
"tool": "get_automation_details",
"params": { "id": "abc123" }
}Notas:
Las credenciales (
CUIT,username,password) se leen de la configuración (src/config.ts).Mientras
statusindique ejecución en curso, vuelve a consultar más tarde con el mismoid.
Crear PDF de comprobante (enlace válido 24 h)
La tool create_pdf genera un PDF a partir de un HTML dinámico y datos del comprobante (incluyendo QR AFIP). Internamente usa ElectronicBilling.createPDF de la SDK de AFIP.
Entrada: datos del comprobante (emisor, receptor, importes, fechas,
CbteTipo,CbteLetra,PtoVta,CbteNro,CbteFch,CAE_NUMBER,CAE_EXPIRY_DATE, moneda, cotización y los ítems de la factura, entre otros).Proceso recomendado: primero recupera los datos con las tools del MCP (voucher, emisor, receptor). El asistente debe mostrar un resumen y requerir confirmación explícita antes de generar el PDF.
Salida: un objeto con
file(URL descargable) y aviso de expiración. El enlace al PDF es válido por 24 horas.
Respuesta típica:
{
"success": true,
"phase": "pdf_created",
"message": "PDF generado correctamente. El enlace expira en 24 horas.",
"file": "https://.../Factura_C_00001_00000001.pdf",
"expiresInHours": 24
}Recomendación:
Usa la numeración automática al emitir el comprobante (ver sección del prompt) para asegurar que
CbteNrosea el correcto antes de crear el PDF.
Solución de problemas (troubleshooting)
Certificados no encontrados o error
ENOENT:Revisa rutas en
.env(AFIP_*_CERT_PATHyAFIP_*_KEY_PATH). Puedes usar rutas absolutas o relativas al raíz del proyecto.
AFIP_PRODUCTION=truepero faltan variables:Define
AFIP_PROD_CERT_PATH,AFIP_PROD_KEY_PATHyAFIP_SDK_ACCESS_TOKENsi tu flujo lo requiere.
Error de autorización de servicio:
Verifica que el CUIT tiene Clave Fiscal 3 y permisos para el servicio (ej.
wsfe,ws_sr_padron_a13).
Versiones de Node incompatibles:
Asegúrate de usar Node 22+ y confirma la versión con
node -v.
Variables de entorno sin definir o certificados ilegibles:
El servidor arranca igual y cada tool responde con
kind: "configuration",code: "CONFIGURATION_ERROR"y la lista de problemas endetails.issues(por ejemploFalta AFIP_PROD_CERT_PATH.).get_certificate_statustambién los informa. Corregí la configuración y reiniciá el servidor MCP.AFIP_PASSWORDyAFIP_CERT_ALIASno son necesarias para el servidor; solo las usan las automatizaciones de certificados y autorización.
Configuración del cliente MCP (archivo JSON)
Muchos clientes MCP aceptan un archivo de configuración JSON (por ejemplo mcp.json o mcp_config.json) donde se definen los servidores. A continuación se muestra un ejemplo genérico para registrar este servidor como arca-mcp.
Ejemplo (Windows, con rutas absolutas a los certificados):
{
"arca-mcp": {
"command": "npx",
"args": ["-y", "@yoryoboy/arcamcp@latest"],
"env": {
"AFIP_CUIT": "20123456789",
"AFIP_DEV_CERT_PATH": "C:\\ruta\\a\\ArcaMCP\\certs\\dev\\dev_certificado.crt",
"AFIP_DEV_KEY_PATH": "C:\\ruta\\a\\ArcaMCP\\certs\\dev\\dev_private.key",
"AFIP_PROD_CERT_PATH": "C:\\ruta\\a\\ArcaMCP\\certs\\prod\\prod_certificado.crt",
"AFIP_PROD_KEY_PATH": "C:\\ruta\\a\\ArcaMCP\\certs\\prod\\prod_private.key",
"AFIP_SDK_ACCESS_TOKEN": "apikey",
"AFIP_PRODUCTION": "true"
}
}
}Ejemplo (rutas relativas al directorio de trabajo del cliente MCP):
{
"arca-mcp": {
"command": "npx",
"args": ["-y", "@yoryoboy/arcamcp@latest"],
"env": {
"AFIP_CUIT": "20123456789",
"AFIP_DEV_CERT_PATH": "./certs/dev/dev_certificado.crt",
"AFIP_DEV_KEY_PATH": "./certs/dev/dev_private.key",
"AFIP_PROD_CERT_PATH": "./certs/prod/prod_certificado.crt",
"AFIP_PROD_KEY_PATH": "./certs/prod/prod_private.key",
"AFIP_SDK_ACCESS_TOKEN": "apikey",
"AFIP_PRODUCTION": "true"
}
}
}Notas importantes:
Ajustá las rutas de certificados de
enva tu entorno. En Windows se debe escapar la barra invertida (\\) en JSON.Podés usar rutas relativas si conocés el directorio de trabajo del cliente MCP; las rutas absolutas suelen ser más confiables.
Si trabajas en homologación, define
"AFIP_PRODUCTION": "false"y usa los certificados de dev.
Uso del prompt de creación de comprobantes
Este repositorio incluye un prompt para asistir en la creación de comprobantes: src/prompts/CreateVoucherPrompt/CreateVoucherPrompt.ts.
Nombre del prompt:
wizard_crear_comprobante.Objetivo: recopilar y validar datos para crear un comprobante en AFIP y ejecutar la tool correspondiente.
Herramientas involucradas:
create_next_voucher(numeración automática) ocreate_voucher(manual), además de herramientas auxiliares para tipos, puntos de venta, etc.
Recomendación:
Pon la numeración en modo automático (campo
modoNumeracion="automatico") para que AFIP/ARCA asigne el número de voucher correcto y evites inconsistencias.
Ejemplo de invocación de argumentos (conceptual):
{
"prompt": "wizard_crear_comprobante",
"args": {
"tipoComprobante": 11,
"puntoDeVenta": 1,
"concepto": 1,
"modoNumeracion": "automatico"
}
}El asistente completará datos faltantes, validará reglas (por ejemplo Factura C, condiciones del receptor) y, tras confirmación explícita, ejecutará create_next_voucher para obtener CAE, fecha de vencimiento del CAE y el número de comprobante.
Seguridad
No compartas tu
.envni subas certificados a repositorios públicos.Restrinje permisos del sistema de archivos a las claves privadas.
Considera encriptar el almacenamiento de certificados en equipos compartidos.
Contribuir
¡Las contribuciones son bienvenidas! La mejor forma de colaborar en este proyecto aquí en GitHub es la siguiente:
Reporta issues: abre un Issue con un título claro, contexto, pasos para reproducir y comportamiento esperado.
Propón mejoras: para nuevas features, abre primero un Issue/Discussion para alinear el alcance.
Envía Pull Requests (PRs):
Haz un fork del repo y crea una rama desde
main(por ejemplo,feat/mi-mejoraofix/mi-bug).Instala dependencias con
pnpm instally prueba en local conpnpm run dev.Asegúrate de que el código compile (
pnpm run build) y que pasepnpm run quality.Incluye documentación actualizada en
README.mdcuando aplique (por ejemplo, variables nuevas, pasos, comandos).No incluyas secretos ni certificados en los commits (usa variables de entorno y rutas locales).
Describe claramente los cambios en el PR y referencia el Issue relacionado (
Fixes #<n>si corresponde).
Estilo y buenas prácticas:
TypeScript y ES Modules (ver
package.jsonytsconfig.json).Mantén el código y mensajes en español cuando ayuden a la comunidad local (AFIP/ARCA).
Sigue convenciones de commits (p. ej.
feat:,fix:,docs:) para facilitar el historial.
Licencia y autor
Licencia: MIT
Autor: Jorge Diaz
Available Tools
20 toolscreate_next_voucherCrear próximo comprobante electrónicoADestructive
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.
Inputs: MonId (required), ImpIVA (required), PtoVta (required), CbteFch (required), +18 more.
create_pdfCrear PDF de facturaA
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.
Inputs: PtoVta (required), CbteFch (required), CbteNro (required), CbteTipo (required), +23 more.
create_voucherCrear comprobante electrónicoCDestructive
Crear un comprobante electrónico en AFIP con CAE asignado
Inputs: MonId (required), ImpIVA (required), PtoVta (required), CantReg (required), +22 more.
get_aliquot_typesObtener tipos de alícuotasARead-only
Obtiene los tipos de alícuotas de IVA disponibles en AFIP (0%, 10.5%, 21%, 27%, etc.).
Inputs: no named parameters.
get_automation_detailsObtener detalles de automatizaciónARead-only
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.
Inputs: id (required), wait.
get_certificate_statusGet X.509 certificate statusARead-only
Returns the loaded X.509 certificate validity status without exposing certificate, key, identity, issuer, subject, or local paths.
Inputs: no named parameters.
get_concept_typesObtener tipos de conceptosARead-only
Obtiene los tipos de conceptos disponibles en AFIP (Productos, Servicios, Productos y Servicios).
Inputs: no named parameters.
get_cuit_from_dniObtener CUIT a partir de DNICRead-only
Obtiene el CUIT de un contribuyente a partir de su DNI
Inputs: nationalId (required).
get_currencies_typesObtener tipos de monedasARead-only
Obtiene los tipos de monedas disponibles en AFIP (ARS, USD, EUR, etc.).
Inputs: no named parameters.
get_document_typesObtener tipos de documentosARead-only
Obtiene los tipos de documentos disponibles en AFIP (DNI, CUIT, CUIL, Pasaporte, etc.).
Inputs: no named parameters.
get_exchange_rateObtener cotización de monedaBRead-only
Obtiene la cotización de una moneda específica para una fecha determinada desde AFIP.
Inputs: MonId (required), FchCotiz (required).
get_last_voucherObtener número último comprobante creadoCRead-only
Obtener número último comprobante creado
Inputs: PtoVta (required), CbteTipo (required).
get_options_typesObtener tipos de opcionesCRead-only
Obtiene los tipos de opciones disponibles para los comprobantes en AFIP.
Inputs: no named parameters.
get_sales_pointsObtener puntos de venta disponiblesARead-only
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).
Inputs: no named parameters.
get_tax_condition_typesObtener tipos de condiciones IVAARead-only
Obtiene los tipos de condiciones frente al IVA disponibles en AFIP (Responsable Inscripto, Monotributista, Exento, etc.).
Inputs: no named parameters.
get_taxpayer_detailsObtener datos del contribuyenteCRead-only
Obtiene los datos completos de un contribuyente a partir de su CUIT
Inputs: taxId (required).
get_tax_typesObtener tipos de tributosARead-only
Obtiene los tipos de tributos disponibles en AFIP (IIBB, impuestos municipales, etc.).
Inputs: no named parameters.
get_voucher_infoObtener información de comprobanteBRead-only
Obtener información completa de un comprobante ya emitido en AFIP
Inputs: PtoVta (required), CbteNro (required), CbteTipo (required).
get_voucher_typesObtener tipos de comprobantesBRead-only
Obtiene los tipos de comprobantes disponibles en AFIP (Factura A, B, C, Nota de Crédito, etc.).
Inputs: no named parameters.
mis_comprobantesListar comprobantes (Mis Comprobantes)ARead-only
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.
Inputs: t (required), fechaEmision (required), wait, nroDoc, +6 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.
Maintenance
Related MCP Connectors
Hosted Argentine commerce MCP: real AFIP invoicing, MercadoPago, logistics, catalog & WhatsApp.
Argentina AFIP/ARCA electronic invoices for AI agents - issue & query facturas, get CAE via WSFE.
MCP server for ABRA Flexi — accounting, contacts, stock and draft-checked invoice creation.
Brazilian fiscal MCP server - issue NF-e, NFC-e, NFS-e, CT-e, MDF-e and DC-e via SEFAZ.
Related MCP Servers
- AlicenseAqualityFmaintenanceArgentine electronic invoicing (facturación electrónica) MCP Server for ARCA/AFIP. Emit invoices, manage credentials, check delegations, and look up taxpayers. 10 tools.12378 npmMIT
- AlicenseAqualityDmaintenanceMCP server for Italian electronic invoicing via the Invoicetronic API, enabling management of invoices through SDI with 20 tools for sending, receiving, exporting, and more.18MIT
- AlicenseNot gradedqualityDmaintenanceMCP server to issue ARCA/AFIP Factura C for monotributistas using Afip SDK, PostgreSQL, and a secure preview-before-emission flow.MIT
- AlicenseNot gradedqualityCmaintenanceHosted MCP server for Argentine commerce: real AFIP/ARCA fiscal invoicing (live CAE), MercadoPago payments, logistics, catalog, cash register and WhatsApp behind one authenticated endpoint. Includes 9 no-auth fiscal validation/formatting tools.MIT