Este proyecto Implementa un servidor MCP (모델 콘텍스트 프로토콜) orientado a integrarse con AFIP (아르헨티나) y automatizar tareas claves del flujo de facturación electrónica y 상담사 de padrone. Aprovecha la SDK oficial de AFIP (@afipsdk/afip.js]) y automatizaciones para:

• Generar y gestionar certificados X.509 (dev y producción).
• Autorizar 웹 서비스 (ej. wsfe, ws_sr_padron_a13).
• Interactuar con servicios AFIP para emisión y 상담사 de comprobantes.
• Estandarizar configuraciones, 변수 de entorno y rutas de certificados.

Además, el paquete incluye los comandos arcamcp setup y arcamcp doctor], que automatizan y 진단 el onboarding en AFIP, reduciendo tiempos de configuración y posibles 설명서.

리퀴시토

• Node.js 20 o 우수
• pnpm (la versión canónica la 정의 el campo packageManager] de package.json)
• Acceso a tu CUIT y a tu cuenta 드 AFIP
• Fiscal nivel 3 o 우수
• (Opcional pero recomendado) Git 파라 클로나 el repositorio

Instalación rápida

아니 necesitás clonar el repositorio ni instalar el paquete globalmente. 프로젝트 20 o 우수, Clave Fiscal nivel 3 y 액세스 토큰 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.