arca-agro

arca-agro-mcp

ARCA の電子貨物運送状を照会する、初の MCP サーバーです。 同機関に対応する他のアルゼンチンの MCP サーバーは、電子請求書と 納税者登録情報までしか対応していません。

エージェントから ARCA（旧 AFIP）の農業関連ウェブサービスを照会するための 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. CUIT 用に ARCA が発行したX.509 証明書と、その秘密鍵。 ポータルのデジタル証明書管理から申請します。
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 件が含まれます。1 シーズン分では数百件になるため、すべて出力すると誰も読まないままコンテキストウィンドウを埋めてしまいます。detalle: trueを指定すると全件を一覧表示しますが、短い期間に限って使うことをおすすめします。

貨物運送状の PDF も送信されません。数百 KB あり、モデルには役立たないためです。ファイルが必要な場合は、ライブラリを使ってダウンロードしてください。

以下の内容

実際の処理はすべて arca-agro-client が担っています。 ここには、発見が難しい癖についても記載されています。たとえば、なぜアクセストークンをディスクにキャッシュする必要があるのか、なぜ WSCPE の SOAPAction がルート要素名と一致しないのか、そしてなぜ証憑を fetch で接続できないのか、といったことです。

ARCA が許可していないこと

ウェブサービス経由で、自分が発送した運送状を一覧表示する方法はありません。 consultarCPEPorDestino で一覧表示できるのは、自分の施設に到着するものだけで、その番号が必要です。発送しか行わない生産者には、どうしようもありません。この一覧はポータルからしか取得できません。正しいパラメーターを探して午後を無駄にする前に、知っておくとよいでしょう。

対応していない範囲

WSLPG（穀物の一次清算）は対応していません。このサービスでは CUIT による一覧表示ができず、PDF も返されないため、本当に必要なユースケースである受領したすべてのものの照合を解決できません。

電子納品書や業界別清算（タバコ、酪農、畜産）も対象外です。追加することは可能です。

開発

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

注意

ARCA とは無関係の独立したプロジェクトです。税務または商取引に関する判断を行う前に、公式情報を確認してください。

プライバシー

お使いのマシンでお持ちの認証情報を使って動作し、機関とのみ通信します。情報を収集したり、どこかに送信したりすることはありません。詳細は PRIVACY.md をご覧ください。

サポート

現状のまま公開しています。問い合わせはリポジトリの issue からお願いします。回答期限はなく、対応できるときにお返事します。メールや電話でのサポートはありません。

サードパーティの API は予告なく変更され、動作しなくなる場合があります。専門的な助言ではありません。使用は利用者の責任で行ってください。

役に立った場合

⭐ リポジトリにスターを付けるか、コーヒーをおごってください。

（あるいは連絡して、おしゃべりするのでも大丈夫です。）

ライセンス

MIT