ArcaMCP

Servidor MCP para AFIP/ARCA: automatiza certificados, autorización de Web Services, emisión/consulta de comprobantes y generación de PDF con QR.

Installation

Run this command in your terminal to add the MCP server to Claude Code.

Run in terminal:

View docs

Command

claude mcp add --transport stdio yoryoboy-arcamcp node src/index.ts \
  --env AFIP_CUIT="CUIT del contribuyente" \
  --env AFIP_PASSWORD="contraseña AFIP" \
  --env AFIP_CERT_ALIAS="alias del certificado" \
  --env AFIP_PRODUCTION="true|false" \
  --env AFIP_DEV_KEY_PATH="ruta a la clave de desarrollo" \
  --env AFIP_DEV_CERT_PATH="ruta al certificado de desarrollo" \
  --env AFIP_PROD_KEY_PATH="ruta a la clave de producción" \
  --env AFIP_PROD_CERT_PATH="ruta al certificado de producción" \
  --env AFIP_SDK_ACCESS_TOKEN="token de acceso de la SDK (solo producción)"

How to use

ARCA MCP es un servidor MCP (Model Context Protocol) orientado a integrarse con AFIP y automatizar tareas clave del flujo de facturación electrónica y consulta de padrones. Aprovecha la SDK oficial de AFIP para gestionar certificados, autorizar Web Services y emitir/consultar comprobantes. Entre las herramientas disponibles se encuentran scripts de automatización que generan certificados de producción, autorizan servicios como wsfe y ws_sr_padron_a13, y facilitan la gestión de certificados y credenciales. El servidor expone una interfaz MCP que puede ser ejecutada en modo desarrollo o producción; para inspección y diagnóstico, puedes usar el Inspector MCP y los scripts de automatización incluyen en el repositorio.

How to install

Prerequisitos:

Node.js 18 LTS o superior (recomendado 20+)
npm 9+ (o pnpm/yarn)
Acceso a tu CUIT y a tu cuenta de AFIP
Clave Fiscal nivel 3 o superior
Git (opcional pero recomendado)

Instalación:

Clona el repositorio y entra al directorio del proyecto: git clone <repositorio> && cd <carpeta-del-repo>
Instala dependencias: npm install
Crea un archivo .env en la raíz con las variables necesarias (ver Configuración) con al menos: AFIP_CUIT=20123456789 AFIP_PASSWORD=tu_password_afip AFIP_CERT_ALIAS=mi-cert-prod 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_PRODUCTION=false AFIP_SDK_ACCESS_TOKEN=tu_sdk_access_token (si aplica)
(Opcional) Inspecciona el servidor MCP con el Inspector: npm run inspector
Ejecuta el servidor en desarrollo (modo dev): npm run dev

Notas:

El repositorio espera que uses tsx para scripts TypeScript. Si no tienes tsx global, puedes instalarlo o invocar con npx tsx <archivo>.

Additional notes

Consejos y notas útiles:

Verifica las rutas de certificados en .env; el código carga los archivos con fs.readFileSync.
Si AFIP_PRODUCTION=true, asegúrate de proporcionar AFIP_PROD_CERT_PATH, AFIP_PROD_KEY_PATH y, si aplica, AFIP_SDK_ACCESS_TOKEN.
Los scripts de automatización permiten crear certificados de producción y autorizar servicios (wsfe, ws_sr_padron_a13). Usa npx tsx scripts/getProdCerts.ts y npx tsx scripts/authService.ts <servicio> para interactuar.
El Inspector ayuda a entender la configuración y el estado del MCP; úsalo durante la integración.
Este MCP está diseñado para integrarse con AFIP. Mantén las credenciales y certificados en lugares seguros y no los commitees en Git.

Related MCP Servers

obsidian -tools

612

Add Obsidian integrations like semantic search and custom Templater prompts to Claude or any MCP client.

ironcurtain

A secure* runtime for autonomous AI agents. Policy from plain-English constitutions. (*https://ironcurtain.dev)

CanvasMCPClient

Canvas MCP Client is an open-source, self-hostable dashboard application built around an infinite, zoomable, and pannable canvas. It provides a unified interface for interacting with multiple MCP (Model Context Protocol) servers through a flexible, widget-based system.

vikunja

Model Context Protocol server for Vikunja task management. Enables AI assistants to interact with Vikunja instances via MCP.

grok-faf

First MCP server for Grok | FAST⚡️AF • URL-based AI context • Vercel-deployed

mcp-turso

MCP server for interacting with Turso-hosted LibSQL databases