Peru Sunat Ruc

@pipeworx/peru-sunat-ruc

ペルーのSUNAT（税務当局）の納税者登録簿「Padron reducido del RUC」です。11桁の会社RUCすべてについて、登録名（razon social）、納税者ステータス（有効、登録抹消、停止など）、住所状況（habido / no habido など）、および法人の場合は登録住所とINEI ubigeoコードを収録しています。 2026-10-29版の時点で、会社および政府機関のRUCを約237万件収録しています（個人は除外）。

Pipeworxの一部です。AIエージェントを1863以上の稼働中のデータソースに接続するMCPゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとの提携、承認、または同プロバイダーによる公開はありません。

latam-validateが確認するのはRUCの形式のみです。このパックでは、RUCがSUNATの登録簿に含まれているか、およびその状態を確認できます。

ツール

• pe_ruc(ruc) — 11桁のRUCで納税者を1件検索します。found: falseの場合は、reason（bad_format、またはcheck_digit_validを伴うnot_in_register）とdata_as_ofを返します。空のオブジェクトは返しません。
• pe_ruc_search(name, ubigeo?, active_only?, limit?) — 法人を対象とした、アクセント記号を区別しない名称検索です（3文字以上の単語はすべて一致する必要があります）。有効な登録を先に表示し、任意でubigeoの接頭辞を指定できます（2桁＝県、4桁＝州、6桁＝地区）。

すべての応答にdata_as_ofとsourceが含まれます。ステータスと住所状況はSUNATの公表どおりに返され（公表元はラベルを20文字に切り詰めます。例：BAJA PROV. POR OFICI）、あわせて可能な範囲で英語の説明も返します。

自然人は対象外です

このパックの対象は会社および組織のみです（RUCの接頭辞20、および政府機関の接頭辞00。登録件数は約237万件）。個人（RUCの先頭が10、15、17のもの。登録簿全体の約1610万件）は保存、検索、または検索対象にはなりません — Bruceの裁定、2026-10-29。個人のRUCに対するpe_rucは、RUCの接頭辞のみを基にfound: false, reason: "natural_person_not_served"を返します。データベースを読み取ることも、氏名、ステータス、番号の存在有無を開示することもありません。ローダーは書き込み前に、これらの接頭辞を除外します。

認証

キーは不要です。ツールはPipeworxゲートウェイ経由でのみ動作します（登録簿はゲートウェイ側のデータベースに保存されています）。単独でインストールすると、空の結果ではなく、明示的なStoreUnavailableErrorが返されます。

データソースと再利用条件

• SUNAT（ペルー国立税務税関監督庁、Superintendencia Nacional de Aduanas y de Administracion Tributaria）「Padron reducido del RUC」。毎日更新される一括ファイルとして公開されています（ページ上の表示「Actualizado al DD/MM/YYYY」）。各応答のdata_as_ofは、読み込まれた版の表示日です。取得処理はCLAUDE.mdのステップ9bに従い、scripts/peru-sunat-ruc/内にのみ存在し、公開されません。
• 再利用条件は公表されていません。 公表元のダウンロードページ（2026-10-29閲覧）には、「Padron Reducido」というタイトル、日付表示「(Actualizado al 29/10/2026)」、および2つのダウンロードリンクのみが掲載されています。ライセンス、利用規約、再配布に関する記述はありません。ペルーの公開税務登録データであり、認証なしで誰でも利用でき、再配布を禁じる記述もないため、明示的な再利用許可なしとここに明記したうえで提供します。

更新

bash scripts/peru-sunat-ruc/refresh.sh loadは該当版をダウンロードし、ローカルのSQLiteファイルを作成します（ISO-8859-1、区切り文字は|、\|はリテラルのパイプ文字をエスケープします。不明なステータス、不正な行、ダウンロードの切り詰めがあれば、エラーを明示して停止します）。D1のテーブルを置き換え、トライグラムの名称インデックスをバッチ処理で作成し、完全性を検証します。refresh.sh verifyは読み取り専用です。verify --self-testでは、完全性チェックが失敗することを確認できます。

クイックスタート

MCPクライアント（Claude Desktop、Cursor、Windsurfなど）に追加します。

{
  "mcpServers": {
    "peru-sunat-ruc": {
      "url": "https://gateway.pipeworx.io/peru-sunat-ruc/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/peru-sunat-ruc/mcp の tools/list は、上の表にあるツールに加えて、Pipeworx 共通のメタツール（ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で利用できるツール）も返します。そのため、表示されるツール数はこの表より多くなります。単一パックのエンドポイントには現在、パック固有のツールとともに、共通ツールがおよそ 30 個一覧表示されます。接続の initialize レスポンスには正確な対象範囲が記載されており、その日の状況を確認する際の正式な情報源となります。

これは意図的な設計であり、偶然の多重化ではありません。メタツールを使うと、このパックでは対応できない質問にも、カタログ全体を対象にルーティングする ask_pipeworx を通じて回答できるため、2 つ目の MCP サーバーを追加する必要がありません。現時点では、メタツールなしでパックのエンドポイントを接続する方法はありません。追加のスキーマによるコンテキスト消費が、ルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度接続してください。

または、Pipeworx のフルゲートウェイに接続すると、このパックのものだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと同じ 1863 以上のデータソースにつながります。違いは、どのパックのツールが直接一覧表示されるかだけです。ask_pipeworx を使えば、どちらからでもすべてのツールを利用できます。

MCP クライアントをお持ちでない場合：HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/pe_ruc \
  -H 'Content-Type: application/json' \
  -d '{"ruc":"20100070970"}'

最初の呼び出しではアカウントは不要です。任意のツールの詳細を確認するには、GET https://gateway.pipeworx.io/v1/tools/pe_ruc を使用します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使用します。

npm から実行する

@pipeworx/mcp-peru-sunat-ruc は、Pipeworx ゲートウェイへのローカル stdio ブリッジです。MCP クライアントが npx で起動し、すべての呼び出しを上記と同じ https://gateway.pipeworx.io/peru-sunat-ruc/mcp エンドポイントに転送します。ネットワーク接続が必要です。オフラインモードはありません。

{
  "mcpServers": {
    "peru-sunat-ruc": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-peru-sunat-ruc"]
    }
  }
}

キーがない場合は匿名で呼び出され、1 日あたり 50 回までに制限されます。無料アカウントを作成すると、1 日あたり 200 回まで利用できます。https://pipeworx.io/signup でキーを取得し、サーバーエントリに "env": { "PIPEWORX_API_KEY": "<your key>" } を追加してください。 キーは、ホスト型接続と同じ方法で Bearer トークンとして送信されるため、呼び出しはそこでの場合と同じように計測され、課金されます。

デフォルトでは、このパックのツールのみが一覧表示されます。PIPEWORX_META_TOOLS=1 を設定すると、ask_pipeworx やその他のゲートウェイ共通ツールも一覧表示されます。

HTTPS プロキシ経由の場合：Node の組み込み fetch は、デフォルトでは HTTPS_PROXY を読み取りません。新しい Node リリースでは、NODE_USE_ENV_PROXY=1 を設定すると反映されます。お使いの Node バージョンのドキュメントを確認してください。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは上記のパックエンドポイントでも、フルゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Peru Sunat Ruc data" })

ゲートウェイが適切なツールを選択し、引数を自動的に入力します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT