Skip to main content
Glama
arca-agro-mcp

arca-agro-mcp

arca-agro-mcp

npm Registro MCP Node License

El primer servidor MCP que consulta cartas de porte electrónicas de ARCA. Los demás MCP argentinos del organismo se detienen en factura electrónica y padrón.

Servidor MCP para consultar los web services agropecuarios de ARCA (ex AFIP) desde un agente: cartas de porte electrónicas, padrón de contribuyentes y comprobantes.

Es de solo lectura, y eso no es una convención de este repo sino una decisión de diseño. Ninguna herramienta autoriza, confirma o anula documentos fiscales, y la librería que usa por debajo —arca-agro-client— tampoco implementa esas operaciones: no hay una bandera que las habilite. Una carta de porte anulada por error es un hecho irreversible ante el organismo, y un modelo de lenguaje no debería tener esa capacidad al alcance. Hay tests que fallan si aparece una herramienta con nombre de escritura.

Instalación

No hace falta instalar nada: se descarga solo al arrancar.

Claude Code

claude mcp add arca-agro \
  --env ARCA_CERT=/ruta/al/certificado.crt \
  --env ARCA_KEY=/ruta/a/la/clave.key \
  --env ARCA_CUIT=30123456789 \
  -- npx -y arca-agro-mcp

Claude Desktop u otro cliente con archivo de configuración

{
  "mcpServers": {
    "arca-agro": {
      "command": "npx",
      "args": ["-y", "arca-agro-mcp"],
      "env": {
        "ARCA_CERT": "/ruta/al/certificado.crt",
        "ARCA_KEY": "/ruta/a/la/clave.key",
        "ARCA_CUIT": "30123456789"
      }
    }
  }
}

Necesita Node 18+ y el comando openssl disponible, que se usa para firmar localmente el pedido de ticket.

Related MCP server: Receita Federal: NFS-e

Qué hace falta antes

  1. Un certificado X.509 emitido por ARCA para tu CUIT, con su clave privada. Se tramita en el portal, en Administración de Certificados Digitales.

  2. Tener habilitado cada servicio en el Administrador de Relaciones. WSCPE, padrón y comprobantes se habilitan por separado.

La clave privada nunca sale de tu máquina: se usa para firmar el pedido de ticket y nada más. Aun así, es una credencial fiscal — tratala como tal y no la pongas en un archivo de configuración compartido.

Herramientas

Herramienta

Qué hace

consultar_cpe

Datos de una carta de porte por su CTG: grano, pesos, estado, CUIT que intervienen.

cpes_recibidas_en_planta

Cartas de porte que llegaron a una planta propia en un rango. Es la consulta del que recibe.

tipos_de_grano

Códigos de grano que ARCA reconoce hoy, consultados en vivo.

ultimo_nro_orden

Último número de orden emitido, para detectar saltos de numeración.

consultar_padron

Razón social, estado de clave, domicilio, régimen e impuestos de un CUIT.

consultar_comprobante

Detalle de un comprobante emitido: importes, IVA, CAE.

estado_servicios

Si los servidores de ARCA responden. No usa el certificado.

Preguntas que contesta bien:

  • ¿Qué dice la carta de porte con CTG 12345678901?

  • ¿Cuántas toneladas de soja entraron a la planta 22397 entre marzo y mayo?

  • ¿Quién es el CUIT 30500120882 y qué régimen tiene?

  • ¿Hay algún salto en la numeración de mis cartas de porte?

  • ¿ARCA está caído o es problema de mis credenciales?

Sobre el volumen de datos

cpes_recibidas_en_planta devuelve por defecto un resumen: totales por grano más las 20 cartas más recientes. Una campaña entera son cientos de cartas y volcarlas todas llena la ventana de contexto sin que nadie las lea. Con detalle: true se listan completas — conviene solo para rangos cortos.

El PDF de la carta de porte tampoco viaja: pesa cientos de KB y no le sirve a un modelo. Si hace falta el archivo, se baja con la librería.

Qué hay abajo

Todo el trabajo sucio lo hace arca-agro-client, donde además están documentados los quirks que cuesta descubrir: por qué el Ticket de Acceso hay que cachearlo en disco, por qué el SOAPAction de WSCPE no coincide con el nombre del elemento raíz, y por qué los comprobantes no conectan con fetch.

Lo que ARCA no deja hacer

No hay forma de listar por web service las cartas de porte que uno despacha. consultarCPEPorDestino lista lo que llega a una planta propia y exige su número. Un productor que solo despacha no tiene con qué: ese listado solo se consigue por el portal. Conviene saberlo antes de perder una tarde buscando el parámetro correcto.

Qué no cubre

WSLPG (liquidación primaria de granos) no está: el servicio no permite listar por CUIT ni devuelve el PDF, así que no resuelve el caso de uso real, que es conciliar todo lo recibido.

Tampoco los remitos electrónicos ni las liquidaciones sectoriales (tabaco, lechería, pecuario). Se pueden agregar.

Desarrollo

npm install
npm run check
npm test
npx @modelcontextprotocol/inspector node server.js

Aviso

Proyecto independiente, sin relación con ARCA. Verificá contra la fuente oficial antes de tomar una decisión fiscal o comercial.

Privacidad

Corre en tu máquina, con tus credenciales, y habla solo con el organismo. No recolecta nada ni manda nada a ningún lado. El detalle, en PRIVACY.md.

Soporte

Esto se publica tal cual está. Las consultas van por los issues del repo, sin plazo de respuesta: lo contesto cuando puedo. No hay soporte por correo ni por teléfono.

Las APIs de terceros cambian sin avisar y pueden romperlo. No es asesoramiento profesional — el uso es responsabilidad de quien lo usa.

Si te sirvió

⭐ Dejame una estrella en el repo o invitame un cafecito.

(O escribime y charlamos, también vale.)

Licencia

MIT

Available Tools

7 tools
consultar_comprobanteConsultar un comprobante emitidoA

Detalle de un comprobante ya emitido: importes, IVA, CAE y estado. Solo consulta: no autoriza comprobantes ni pide CAE.

Inputs: numero (required), puntoVenta (required), tipoComprobante (required).

consultar_cpeConsultar una carta de porteA

Datos completos de una carta de porte electrónica a partir de su CTG: grano, pesos, estado, fechas y los CUIT que intervienen. Incluye los pesos tomados en la balanza del destino, que son los que sirven para conciliar contra balanza propia.

Inputs: nroCTG (required).

consultar_padronConsultar el padrón por CUITA

Razón social, estado de la clave fiscal, domicilio, régimen impositivo, impuestos y actividades de un CUIT. Sirve para saber contra quién se está operando y qué tratamiento impositivo le corresponde.

Inputs: cuit (required).

cpes_recibidas_en_plantaCartas de porte recibidas en una plantaA

Cartas de porte que LLEGARON a una planta propia dentro de un rango de fechas. Es la consulta del que recibe la mercadería, no del que la despacha: ARCA exige el número de planta y no ofrece el listado inverso. Quien solo despacha no puede usar esto. Por defecto devuelve un resumen (totales por grano y las 20 más recientes); pedir detalle solo para rangos cortos, porque una campaña entera son cientos de cartas.

Inputs: desde (required), hasta (required), planta (required), detalle.

estado_serviciosEstado de los servicios de ARCAA

Chequea si los servidores de ARCA están respondiendo. No usa el certificado ni consulta datos de nadie: es lo primero que conviene mirar cuando algo falla, para separar una caída del organismo de un problema de credenciales.

Inputs: no named parameters.

tipos_de_granoTabla de códigos de granoA

Códigos de grano que reconoce ARCA hoy, consultados en vivo. Útil para traducir el código que trae una carta de porte, y para descartar códigos de planillas viejas que el organismo ya no reconoce.

Inputs: no named parameters.

ultimo_nro_ordenÚltimo número de orden de CPEA

Último número de orden de carta de porte emitido para una sucursal y tipo de CPE. Sirve para detectar saltos de numeración.

Inputs: tipoCPE, sucursal.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool targets a distinct entity or operation: CPE lookup, grain code catalog, service health, received CPE list, last order number, tax registry, and invoice detail. There is no meaningful overlap between tools.

    Naming Consistency3/5

    All names are snake_case吠, but only three follow a verb_noun pattern with consultar_*. The rest are noun phrases like tipos_de_grano, estado_servicios, cpes_recibidas_en_planta, and ultimo_nro_orden, making the convention mixed though still readable.

    Tool Count5/5

    Seven tools is well-scoped for a focused read-only agricultural/tax data server. Each tool earns its place and there is no unnecessary redundancy.

    Completeness4/5

    The set covers the main read-side needs: CPE details, received CPE lists, invoice details, tax registry data, grain codes, numbering gaps, and service health. It is intentionally query-only, so missing creation/authorization tools are not critical, though a tool to list issued CPEs by branch would close a minor gap.

    Maintenance

    ActivitySlowing
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers