Skip to main content
Glama
ArcaMCP

ArcaMCP

by Yoryoboy

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 packageManager de package.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@latest

setup 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:

  1. Cloná el repositorio y entrá en su directorio.

  2. Ejecutá pnpm install.

  3. Ejecutá pnpm run dev setup --dev o creá el archivo .env a mano, y verificá con pnpm run dev doctor.

  4. Iniciá el servidor con pnpm run dev o el Inspector con pnpm 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 con AFIP_PRODUCTION=false): ruta absoluta o relativa al certificado .crt de desarrollo.

  • AFIP_DEV_KEY_PATH (obligatorio con AFIP_PRODUCTION=false): ruta al .key de desarrollo.

  • AFIP_PROD_CERT_PATH (obligatorio con AFIP_PRODUCTION=true): ruta al certificado .crt de producción.

  • AFIP_PROD_KEY_PATH (obligatorio con AFIP_PRODUCTION=true): ruta al .key de producción.

  • AFIP_PRODUCTION: true para producción, false para 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(...) en src/services/afip/client.ts.

  • Si AFIP_PRODUCTION=true, deben existir AFIP_PROD_CERT_PATH, AFIP_PROD_KEY_PATH y, si aplica, AFIP_SDK_ACCESS_TOKEN.

Estructura del proyecto

  • src/config.ts: carga .env y expone configuración.

  • src/services/afip/client.ts: inicializa el cliente de @afipsdk/afip.js con certificados y CUIT.

  • src/index.ts: punto de entrada del bin arcamcp (servidor MCP o comandos setup/doctor).

  • src/server.ts: registra tools y prompts e inicia el servidor MCP por stdio.

  • src/cli/: comandos setup (certificado + autorización de servicios + .env) y doctor.

  • certs/: carpeta sugerida para ubicar certificados (./certs/dev y ./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.

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 --prod

setup:

  1. Toma AFIP_CUIT, AFIP_CERT_ALIAS, AFIP_SDK_ACCESS_TOKEN y AFIP_PASSWORD del 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.

  2. Crea el certificado con la automatización create-cert-dev o create-cert-prod y lo guarda en ./certs/dev/ o ./certs/prod/ (<env>_certificado.crt y <env>_private.key, esta última con permisos 600).

  3. Crea o actualiza .env con AFIP_CUIT, AFIP_CERT_ALIAS, AFIP_SDK_ACCESS_TOKEN y las rutas absolutas AFIP_<DEV|PROD>_CERT_PATH / AFIP_<DEV|PROD>_KEY_PATH, conservando el resto de las líneas. Solo agrega AFIP_PRODUCTION si no existe. La clave fiscal nunca se guarda.

  4. Autoriza wsfe y ws_sr_padron_a13 con auth-web-service-dev o auth-web-service-prod.

  5. 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 .env desde su directorio de trabajo. Si tu cliente MCP lo inicia desde otro directorio, copiá las variables al bloque env del cliente (el que imprime setup).

4) Verificar la configuración

npx -y @yoryoboy/arcamcp@latest doctor

doctor 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 dev

    Esto lanza src/index.ts con tsx en modo desarrollo.

  • Inspector MCP (diagnóstico):

    pnpm run inspector

    Utiliza @modelcontextprotocol/inspector contra 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 -dates

Despué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_voucher y create_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 id y status. No contiene todavía los datos finales; es el identificador de la ejecución.

  • Consulta del resultado: usa posteriormente el tool get_automation_details con ese id para 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 status indique ejecución en curso, vuelve a consultar más tarde con el mismo id.

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 CbteNro sea el correcto antes de crear el PDF.

Solución de problemas (troubleshooting)

  • Certificados no encontrados o error ENOENT:

    • Revisa rutas en .env (AFIP_*_CERT_PATH y AFIP_*_KEY_PATH). Puedes usar rutas absolutas o relativas al raíz del proyecto.

  • AFIP_PRODUCTION=true pero faltan variables:

    • Define AFIP_PROD_CERT_PATH, AFIP_PROD_KEY_PATH y AFIP_SDK_ACCESS_TOKEN si 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 en details.issues (por ejemplo Falta AFIP_PROD_CERT_PATH.). get_certificate_status también los informa. Corregí la configuración y reiniciá el servidor MCP.

    • AFIP_PASSWORD y AFIP_CERT_ALIAS no 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 env a 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) o create_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 .env ni 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-mejora o fix/mi-bug).

    • Instala dependencias con pnpm install y prueba en local con pnpm run dev.

    • Asegúrate de que el código compile (pnpm run build) y que pase pnpm run quality.

    • Incluye documentación actualizada en README.md cuando 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.json y tsconfig.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 tools
create_next_voucherCrear próximo comprobante electrónicoA
Destructive

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ónicoC
Destructive

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ícuotasA
Read-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ónA
Read-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 statusA
Read-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 conceptosA
Read-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 DNIC
Read-only

Obtiene el CUIT de un contribuyente a partir de su DNI

Inputs: nationalId (required).

get_currencies_typesObtener tipos de monedasA
Read-only

Obtiene los tipos de monedas disponibles en AFIP (ARS, USD, EUR, etc.).

Inputs: no named parameters.

get_document_typesObtener tipos de documentosA
Read-only

Obtiene los tipos de documentos disponibles en AFIP (DNI, CUIT, CUIL, Pasaporte, etc.).

Inputs: no named parameters.

get_exchange_rateObtener cotización de monedaB
Read-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 creadoC
Read-only

Obtener número último comprobante creado

Inputs: PtoVta (required), CbteTipo (required).

get_options_typesObtener tipos de opcionesC
Read-only

Obtiene los tipos de opciones disponibles para los comprobantes en AFIP.

Inputs: no named parameters.

get_sales_pointsObtener puntos de venta disponiblesA
Read-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 IVAA
Read-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 contribuyenteC
Read-only

Obtiene los datos completos de un contribuyente a partir de su CUIT

Inputs: taxId (required).

get_tax_typesObtener tipos de tributosA
Read-only

Obtiene los tipos de tributos disponibles en AFIP (IIBB, impuestos municipales, etc.).

Inputs: no named parameters.

get_voucher_infoObtener información de comprobanteB
Read-only

Obtener información completa de un comprobante ya emitido en AFIP

Inputs: PtoVta (required), CbteNro (required), CbteTipo (required).

get_voucher_typesObtener tipos de comprobantesB
Read-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)A
Read-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

    B3.3/5.0

    Scored across 20 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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).

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      F
      maintenance
      Argentine electronic invoicing (facturación electrónica) MCP Server for ARCA/AFIP. Emit invoices, manage credentials, check delegations, and look up taxpayers. 10 tools.
      12
      378 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for Italian electronic invoicing via the Invoicetronic API, enabling management of invoices through SDI with 20 tools for sending, receiving, exporting, and more.
      18
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Hosted 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