arca-agro

arca-agro-mcp

首个可查询 ARCA 电子运输单的 MCP 服务。 该机构的其他阿根廷 MCP 都只支持电子发票和纳税人名录查询。

用于让 Agent 查询 ARCA（前 AFIP）农业相关 Web 服务的 MCP 服务：电子运输单、纳税人名录和凭证。

本服务仅支持只读操作，这不是本项目的惯例，而是设计决策。 任何工具都不会授权、确认或作废税务文件，底层使用的库——arca-agro-client——也没有实现这些操作：不存在可以启用它们的开关。运输单一旦误作废，对该机构而言就是不可逆的，而大模型不应拥有触手可及的这类能力。如果出现名称表示写入操作的工具，测试就会失败。

安装

无需安装任何内容：启动时会自动下载。

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 或其他使用配置文件的客户端

{
  "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"
      }
    }
  }
}

需要 Node 18+，并且系统中要有 openssl 命令，用于在本地为票据请求签名。

使用前的准备

1. 需要一份 ARCA 为你的 CUIT 签发的 X.509 证书及其私钥。请在门户的 Administración de Certificados Digitales 中申请。
2. 需要在关系管理器中启用每项服务。WSCPE、纳税人名录和凭证服务需要分别启用。

私钥不会离开你的设备：它只用于为票据请求签名。尽管如此，它仍是税务凭证——请妥善保管，不要将其放入共享配置文件中。

工具

工具	功能
consultar_cpe	根据 CTG 查询运输单数据：谷物、重量、状态及涉及的 CUIT。
cpes_recibidas_en_planta	查询指定时间范围内抵达自有工厂的运输单。这是收货方的查询。
tipos_de_grano	实时查询 ARCA 当前认可的谷物代码。
ultimo_nro_orden	查询最近签发的订单编号，用于发现编号跳号。
consultar_padron	查询 CUIT 的公司名称、税务识别码状态、地址、税制和税种。
consultar_comprobante	查询已签发凭证的详情：金额、IVA、CAE。
estado_servicios	检查 ARCA 服务器是否有响应。无需使用证书。

可以准确回答的问题：

• CTG 12345678901 对应的运输单上写了什么？
• 3 月至 5 月期间，有多少吨大豆运到了工厂 22397？
• CUIT 30500120882 对应什么主体？适用什么税制？
• 我的运输单编号有没有跳号？
• 是 ARCA 服务中断了，还是我的凭证有问题？

关于数据量

cpes_recibidas_en_planta 默认返回摘要：按谷物统计的总量，以及最近的 20 张运输单。一个完整种植季可能有数百张运输单，全部输出会填满上下文窗口，却没人会去读。设置 detalle: true 可列出全部数据——建议仅用于较短的时间范围。

运输单的 PDF 也不会传输：文件有数百 KB，对大模型没有用。如果需要文件，请使用该库下载。

以下内容

所有繁重的工作都由 arca-agro-client 完成， 其中还记录了那些很难发现的 quirks：为什么必须将 Ticket de Acceso 缓存到磁盘，为什么 WSCPE 的 SOAPAction 与根元素名称 不一致，以及为什么凭证无法通过 fetch 连接。

ARCA 不允许做的事

无法通过 Web 服务列出自己发出的运单。 consultarCPEPorDestino 会列出送达自有工厂的运单，并要求提供运单编号。只负责发货的生产者没有办法查询：只能通过门户获取此列表。在花一下午寻找正确参数之前，最好先了解这一点。

不涵盖的内容

目前不支持 WSLPG（谷物初级结算）：该服务不允许按 CUIT 列表查询，也不会返回 PDF，因此无法解决实际用例，也就是核对收到的所有内容。

电子送货单和行业结算（烟草、乳制品、畜牧业）也不支持。可以添加。

开发

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

声明

这是一个独立项目，与 ARCA 无关。在做出税务或商业决策之前，请对照官方来源核实。

隐私

项目在你的机器上运行，使用你的凭证，且只与相关机构通信。不会收集任何信息，也不会将任何内容发送到其他地方。详情见 PRIVACY.md。

支持

本项目按现状发布。请通过仓库的 issues 提交咨询，但不承诺回复时限：我有空时会回复。不提供电子邮件或电话支持。

第三方 API 可能会在不事先通知的情况下发生变化，并导致项目无法正常运行。本项目不构成专业建议，使用者须自行承担使用责任。

如果对你有帮助

⭐ 请在仓库点个星，或请我喝杯 咖啡。

（或者给我写信聊聊，也可以。）

许可证

MIT