mcp-afip

@codespar/mcp-afip

電子インボイス（Factura Electronica）発行時のCAE認証に対応する、アルゼンチンの税務当局 AFIP（Administracion Federal de Ingresos Publicos）向けMCP サーバーです。

アルファ版 — npm の alpha dist-tag で公開されています。エンドポイントのパスは公開ドキュメントおよび BACEN／プロバイダーの規約に沿っていますが、実環境での検証は完了していません。0.x.x-alpha の間は正確なバージョンを指定してください。npm install @codespar/mcp-afip@alpha でインストールできます。

クイックスタート

# Set your credentials
export AFIP_CERT_PATH="/path/to/cert.crt"
export AFIP_KEY_PATH="/path/to/key.key"
export AFIP_CUIT="20123456789"

# Run via stdio
npx -y @codespar/mcp-afip@alpha

# Run via HTTP
MCP_HTTP=true MCP_PORT=3000 npx -y @codespar/mcp-afip@alpha

環境変数

変数	必須	説明
AFIP_CERT_PATH	はい	AFIP 証明書（.crt）へのパス
AFIP_KEY_PATH	はい	AFIP 秘密鍵（.key）へのパス
AFIP_CUIT	はい	納税者の CUIT 番号
AFIP_ENV	いいえ	"production" または "homologation"（デフォルト：homologation）
MCP_HTTP	いいえ	HTTP トランスポートを有効にするには "true" を設定
MCP_PORT	いいえ	HTTP ポート（デフォルト：3000）

ツール（20）

ツール	用途
create_invoice	AFIP 経由で電子インボイス（Factura Electrónica）を作成
get_invoice	種類、販売拠点、番号を指定してインボイスの詳細を取得
get_last_invoice_number	販売拠点と種類を指定して、最後に認証されたインボイス番号を取得
get_cae_status	インボイスの CAE 認証状況を確認
list_invoice_types	利用可能なインボイスの種類（Factura A、B、C など）を一覧表示
list_tax_types	利用可能な税の種類（IVA、知覚税、源泉徴収税など）を一覧表示
get_server_status	AFIP ウェブサービスの稼働状況（WSFE ステータス）を確認
get_authorized_points_of_sale	CUIT に対して認証された販売拠点を一覧表示
create_invoice_batch	1回の CAE リクエストで複数のインボイスを作成（FECAESolicitar、最大250件）
create_credit_note	元のインボイスを参照するクレジットノート（Nota de Crédito A/B/C：種類3、8、13）を発行
create_debit_note	元のインボイスを参照するデビットノート（Nota de Débito A/B/C：種類2、7、12）を発行
cancel_invoice	認証済みインボイスをキャンセル／無効化（FECancel — 特定の種類／条件に限定）
get_invoice_total_x_request	FECAESolicitar リクエストで許可される最大レコード数を取得（FECompTotXRequest）
list_concept_types	利用可能な取引内容の種類を一覧表示（FEParamGetTiposConcepto：1＝商品、2＝サービス、3＝両方）
list_doc_types	書類／識別番号の種類を一覧表示（FEParamGetTiposDoc：80＝CUIT、86＝CUIL、96＝DNI、99＝最終消費者）
list_iva_types	IVA 税率を一覧表示（FEParamGetTiposIva：21%、10.5%、27%、0% など）
list_currency_types	対応通貨を一覧表示（FEParamGetTiposMonedas）
get_currency_rate	通貨と ARS の為替レート（cotización）を取得（FEParamGetCotizacion）
lookup_taxpayer	CUIT で納税者台帳を照会（WS_SR_PADRON A4/A5/A13 — 税務ステータス、氏名、住所）
get_registration_certificate	CUIT の登録証明書（constancia de inscripción）を取得

認証

証明書ベースの WSAA 認証（SOAP）を使用します。MCP サーバーは、AFIP の SOAP サービス（WSFE）を内部で REST 方式によりラップします。AFIP が発行した有効な証明書が必要です。テストには homologation 環境を使用してください。

API リファレンス

• AFIP ウェブサービスのドキュメント

---

エンタープライズ

エージェントによる支払いのガバナンス、予算上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、支払いルーティング、コンプライアンステンプレートを追加します。

認証

サーバーを起動する前に、以下の環境変数を設定してください。

• AFIP_CERT_PATH (required) — AFIP 証明書（.crt）へのパス
• AFIP_KEY_PATH (required, secret) — AFIP 秘密鍵（.key）へのパス
• AFIP_CUIT (required) — CUIT 番号

認証情報は、プロバイダーの開発者ポータルで発行してください：https://www.afip.gob.ar/ws。

ライセンス

MIT