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.

Реквизиты

• Node.js 20 o superior
• pnpm (la versión canónica la definition 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

Instalación rápida

No necesitás clonar el repositorio ni instalar el paquete globalmente. Con Node.js 20 o superior, Clave Fiscal nivel 3 y un access token de afipsdk.com:

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 20 o superior
• 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

Instalación rápida

No necesitás clonar el repositorio ni instalar el paquete globalmente. Con Node.js 20 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.