Este proyecto の servidor MCP (Model Context Protocol) orientado a Integraarse con AFIP (Argentina) y automatizar tareas claves del Flujo de ファクトラシオン electrónica y のコンサルサデパドローン. Aprovecha la SDK oficial de AFIP ([@afipsdk/afip.js]) y automatizaciones para:

• Generar y gestionar certificados X.509 (dev y produccion).
• Autorizar Web Services (例: wsfe], ws_sr_padron_a13])
• インターアクチュアコンservicios AFIPパラエミシオンyコンサルバテス。
• Estandarizar configuraciones, 変数 de entorno y rutas de certificados.

Además、el paqueteのincluye los comandos arcamcp setup] y [arcamcp doctor]]、que automatizan yの診断AN elのオンボーディング en AFIP、deductiendo tiempos de configuración yの可視誤差マニュアル。

レキサイト

• Node.js 20 o 優れた
• pnpm (la versión canonica la define el campo [packageManager de package.json]))
• アッセオ チュー CUIT y a t cuenta de AFIP
• クローブ・フォー・ザ・ニベル3 o スーペリア
• (Opcionalのperoのrecomendado) Gitパラクローンエルリポジトリ

Instalación ラピダ

necesitás lonar el repositorio ni instalar el paquete globalmente. Con Node.js の構成 20 o 優れ, クローブ フィシス 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.