Skip to main content
Glama
arca-mcp

arca-mcp

by PablosSG85

arca-mcp

Conector para consultar ARCA (ex AFIP) desde Claude, sin abrir el navegador: Mis Comprobantes (facturas recibidas y emitidas), Cuentas Tributarias (deuda y saldos), Mis Facilidades (planes de pago) y Presentación de DDJJ y Pagos (declaraciones presentadas y VEP) de todos tus clientes.

  • Entra con tu propia clave fiscal, guardada cifrada en tu computadora. Nunca con la de un cliente.

  • Tus clientes te delegan los servicios en ARCA, como ya se hace con el contador.

  • Corre en tu computadora: no se publica en internet y nadie más ve tus datos.

  • Sólo consulta. No presenta, no paga, no acepta nada.

Es un proyecto independiente, no es de ARCA. Revisá el código antes de usarlo con datos reales.

Qué necesitás

  • Python 3.11 o más nuevo.

  • Claude Desktop (o Claude Code).

  • Tu clave fiscal nivel 3 o superior.

Related MCP server: arca-agro-mcp

1. Instalar

pip install git+https://github.com/PablosSG85/arca-mcp

2. Guardar tu clave (una sola vez)

arca-mcp-clave

Te pide tu CUIT y tu clave fiscal (no se ve mientras escribís). Queda en el Administrador de credenciales de Windows, el Llavero de Mac o el Secret Service de Linux. Nunca en un archivo.

3. Sumarlo a Claude Desktop

En Claude Desktop: Configuración → Desarrollador → Editar configuración, y agregá:

{
  "mcpServers": {
    "arca": { "command": "C:\\ruta\\completa\\a\\arca-mcp.exe" }
  }
}

Poné la ruta completa del programa: la sacás con where arca-mcp (Windows) o which arca-mcp (Mac y Linux). Claude Desktop no siempre encuentra los programas instalados con pip si sólo ponés el nombre. Reiniciá Claude Desktop. Con Claude Code: claude mcp add arca -- arca-mcp.

4. Que cada cliente te delegue los servicios

El cliente (o el administrador de relaciones, si es una empresa):

  1. Entra a ARCA con su clave fiscal → Administrador de Relaciones de Clave Fiscal.

  2. Nueva Relación → Buscar → elige Mis Comprobantes. Repite para Sistema de Cuentas Tributarias, Mis Facilidades y Presentación de DDJJ y Pagos.

  3. Como representante pone tu CUIT y confirma.

Vos: entrás a ARCA con tu clave → Aceptación de Designación → aceptás cada servicio.

Cómo se usa

Pedile a Claude, por ejemplo:

  • «¿Qué clientes tengo en ARCA?»

  • «Facturas recibidas de 30-12345678-9 en octubre»

  • «Cuentas tributarias 2026 de Pérez SRL: ¿tiene deuda?»

  • «¿Pérez SRL tiene algún plan de pagos vigente?»

  • «¿Qué declaraciones de IVA presentó Pérez SRL este año? ¿Pagó los VEP?»

La primera consulta del día puede tardar un minuto: ARCA es lenta.

Cuidados que trae

  • Un solo intento de ingreso. Si ARCA rechaza la clave, el conector se traba solo para no bloquearte la clave por reintentos. Revisala entrando a ARCA a mano, guardala de nuevo con arca-mcp-clave y destrabalo con arca-mcp-clave --desbloquear.

  • Controla el CUIT en cada pantalla. Si ARCA muestra otro contribuyente, no devuelve esos datos.

  • Nunca inventa ceros. Si ARCA no devolvió el cuadro, la respuesta dice «incompleto», no «sin deuda».

  • Cada consulta queda anotada (sin claves) en registro.jsonl, en la carpeta de datos del usuario (%APPDATA%\arca-mcp en Windows, ~/.local/share/arca-mcp en Mac y Linux). Para usar otra carpeta, definí la variable ARCA_MCP_DATOS igual para Claude y para la terminal donde corrés arca-mcp-clave. Si ARCA rechaza la clave, el mensaje dice dónde quedó el candado.

  • De a una consulta por computadora, aunque tengas el conector en Claude Desktop y en Claude Code a la vez.

  • Una consulta de Cuentas Tributarias puede tardar hasta tres minutos si ARCA está lenta.

Licencia

MIT.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables querying Xubio accounting data (clients, invoices, products, balances) through natural language by exposing 52 read-only API endpoints as MCP tools.
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables read-only queries to ARCA's agricultural web services for electronic waybills, taxpayer registry, and receipts, allowing agents to retrieve fiscal data without modifying documents.
      7
      49 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables Claude to access, analyze, and optionally modify invoices, installments, receipts, clients, and financial reports via the Fatture in Cloud API v2, with read-only default and multi-layer safety.
      17
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents and MCP clients to look up Argentine taxpayers by CUIT and issue, retrieve, email, and download PDFs of ARCA electronic invoices, credit notes, and debit notes, with test/live modes and idempotent retries.
      MIT