Arca Agro MCP server

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-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.

Qué hace falta antes

Se tramita en el portal, en Administración de Certificados Digitales.

1. Un certificado X.509 emitido por ARCA para tu CUIT, con su clave privada.

padrón y comprobantes se habilitan por separado.

1. Tener habilitado cada servicio en el Administrador de Relaciones. WSCPE,

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

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

cpesrecibidasenplanta 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.

Shortened. The full README is on GitHub.