arca-agro-mcp
This server lets an AI agent read-only query ARCA (ex AFIP) agribusiness web services using your own credentials.
consultar_cpe: Get full details of an electronic grain transport document (carta de porte) by CTG number.
cpes_recibidas_en_planta: List or summarise grain transport documents that arrived at your plant within a date range.
tipos_de_grano: Fetch current ARCA grain codes to translate/validate grain types.
ultimo_nro_orden: Get the latest CPE order number for a branch/type to detect numbering gaps.
consultar_padron: Look up a CUIT: legal name, tax status, address, tax regime, and activities.
consultar_comprobante: Retrieve details of an already-issued invoice: amounts, VAT, CAE, status.
estado_servicios: Check whether ARCA servers are responding (without using your certificate).
Read-only by design: No tool can authorise, confirm, or cancel fiscal documents.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@arca-agro-mcp ¿Qué dice la carta de porte con CTG 12345678901?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
arca-agro-mcp
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-mcpClaude 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
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.
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 |
| Datos de una carta de porte por su CTG: grano, pesos, estado, CUIT que intervienen. |
| Cartas de porte que llegaron a una planta propia en un rango. Es la consulta del que recibe. |
| Códigos de grano que ARCA reconoce hoy, consultados en vivo. |
| Último número de orden emitido, para detectar saltos de numeración. |
| Razón social, estado de clave, domicilio, régimen e impuestos de un CUIT. |
| Detalle de un comprobante emitido: importes, IVA, CAE. |
| 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.jsAviso
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 toolsconsultar_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
Scored across 7 tools
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.
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.
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.
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
Related MCP Connectors
Read-only EU e-invoice checks: VAT format, VIES, Peppol lookup. Returns evidence, no filing.
Search existing fiscal documents without creating or cancelling any, in Invoice Maven.
Read-only access to Andorran accounting and tax data in Tributs: invoices, bank, IGI filings.
Argentina AFIP/ARCA electronic invoices for AI agents - issue & query facturas, get CAE via WSFE.
Related MCP Servers
- FlicenseCqualityCmaintenanceExposes read-only Aruba Fatturazione Elettronica API operations for managing electronic invoices, notifications, and providing fiscal document helpers.702-
- AlicenseNot gradedqualityDmaintenanceAllows consultation of NFS-e (electronic service invoices) from the Brazilian Federal Revenue official source, with a single read-only tool.MIT
- AlicenseNot gradedqualityDmaintenanceProvides read-only access to query NFC-e (electronic consumer invoices) from SEFAZ MS using official data sources.MIT
- AlicenseNot gradedqualityDmaintenanceEnables querying official electronic service invoices (NFS-e) from the Cuiabá city government in Brazil, providing read-only access to official data.MIT