IBANforge

ibanforge-mcp

IBANforge の公式 Model Context Protocol (MCP) サーバー です。

支払う前に、IBAN の背後にある銀行を確認できます。89 か国での検証、国の登録簿に基づく銀行コードの判定（このリリースでは DE、AT、BE、SK、BG、CH、LI。最新の一覧は llms.txt にあります）、出典付きの銀行名と BIC、銀行の SEPA、SEPA Instant、VoP への対応状況、銀行レベルの制裁措置（OFAC、EU、UN）を確認できます。

名義確認（VoP、BAV、CoP）ではなく、口座が存在することや開設済みであることの証明でもありません。また、受取人の制裁スクリーニングではなく（銀行と国のみを対象）、ライセンスを受けた SWIFT BIC ディレクトリの複製でもありません。BBAN 内の各国固有のチェックディジット（フランスの RIB キー、イタリアの CIN、スペインの DC、ドイツの口座番号方式）はまだ検証していません。そのため、各国固有のキーが誤っていても mod-97 が正しい IBAN は、有効と判定されます。実行するのは、英国のモジュラスチェックとポーランドの決済番号のチェックディジットのみです。

ビジネスソフトウェアにも AI エージェントにも対応しています。メールアドレス不要の API キー、カードで購入できるプリペイドパック、HTTP API での x402 マイクロペイメントを利用できます。

無料アクセス

この README に数値を記載していないのは意図的です。公開済みのパッケージは次のリリースまでそのままですが、サービスの利用枠は変更される場合があります。現在適用されている数値は、rate-limits.yml と GET /v1 からリアルタイムで取得できます。

• リモート MCP、インストール不要： https://api.ibanforge.com/mcp は、キーやウォレットなしで完全なツール呼び出しに応答します。送信元アドレスごとの専用利用枠（rate-limits.yml の mcp_anonymous）があり、バッチでは IBAN 1 件につき 1 回としてカウントされます。以下の REST トライアルとは別枠です。Authorization: Bearer ヘッダーに API キーを指定すると、REST API と同じく、そのキーの利用枠に対して呼び出しがカウントされます。
• このパッケージ、キーを取得する前： validate_iban は REST API のキーなしトライアル（rest_anonymous_trial）を利用し、送信元アドレスごとにカウントされます。各応答の trial ブロックに、残りの呼び出し回数とカウントのリセット時刻が記載されます。他の有料ツールには、キー、プリペイドクレジット、または x402 が必要です。
• メールアドレスもカードも不要なキー： 空の本文で POST https://api.ibanforge.com/v1/keys/generate を呼び出すと、各エンドポイントに専用の利用枠がある ifk_ キー（anonymous_key）が返されます。この目的で指定したアドレスに送信されるコードを使って POST /v1/keys/claim で認証すると、同じキーの利用枠が拡大されます（free_tier。 同じキーを使い続ける を参照）。

ツール

ツール	説明	費用 (USDC)
validate_iban	単一の IBAN を検証（ISO 13616 mod-97）し、BIC を解決し、発行元（銀行／EMI／vIBAN）を分類し、SEPA + VoP フラグを返します	0.005
batch_validate_iban	1 回の呼び出しで最大 100 件の IBAN を検証します	1 件あたり 0.002
lookup_bic	121k 件以上の BIC エントリー（うち 39k 件以上は GLEIF による LEI 拡充済み）から BIC/SWIFT を検索します	0.003
lookup_ch_clearing	1,100 件以上の SIX BankMaster エントリーからスイスの BC-Nummer／IID を検索します — 全決済レールへの参加状況（SIC、euroSIC、CHF 即時決済）+ QR-IID	0.003
check_compliance	支払い前チェック：IBAN + 受取人の銀行（BIC8）および国に基づいて照合される制裁リスト（OFAC、EU、UN）。受取人の氏名では照合しません + FATF + SEPA Instant + VoP 対応状況 + リスクスコア（0～100）	0.02
validate_payment_reference	構造化された支払参照情報を検証します — RF/ISO 11649（「SCOR」）、スイス QR 参照情報（「QRR」）、ベルギー OGM/VCS、フィンランドの viitenumero。各ルールを公開している日付付き文書に照らして検証します。IBAN を指定すると、QRR↔QR-IBAN の組み合わせ判定を取得できます（validate_iban 1 回分として課金）	無料
check_postal_address	構造化された ISO 20022 郵便住所を、2026 年 11 月の変更に先立ち、SPS（SIX）、HVPS+（T2）、または Fedwire のルールに照らして確認します — 各検出事項には出典文書と日付が記載されます	無料
check_swiss_qr_bill	スイス QR 請求書のテキストペイロードを構造ルールに照らして確認します。受取人口座は検証しません	無料
audit_creditor_file	債権者／仕入先ファイル全体（CSV/XLSX）を監査します：行ごとの IBAN、銀行、BIC、SEPA 到達可能性、住所の適合性に加え、ファイル全体のチェック（重複、BIC の不一致、住所と IBAN の国の不一致）を行います。IBAN をマスキングした無料プレビューを利用できます。注釈付きの完全なレポートは有料です	無料プレビュー（レポート：Stripe 経由で CHF）
audit_status	audit_creditor_file で作成した監査ジョブの支払状況を確認し、支払い後にレポートのダウンロードリンクを取得します	無料
send_feedback	誤ったデータを報告するか、有料の回答が誤っていた場合に x402 の規約で約束されている返金を請求します	無料
request_api_key	人間がブラウザーで承認するキーリクエストを開始します — メールアドレス、カード、アカウントは不要です。短いコードと人間に渡すリンクを表示します	無料
poll_api_key	人間による承認後にキーを取得します。キーは一度だけ渡され、MCP クライアント設定に貼り付ける行も含まれます	無料

USDC 価格は HTTP API での x402 決済価格です。バッチ処理の IBAN 1 件あたりの料金が単件の検証より安くなるのは、この方法だけです。キーまたはプリペイドクレジットの場合、有料の呼び出しごとにリクエスト 1 回分またはクレジット 1 つ分を使用し、バッチ内の IBAN ごとに 1 つずつ使用します。

MCP クライアントから永続キーを取得する

メールアドレス、アカウント、フォームは不要です。4 つの手順で、人間の操作時間は約 15 秒です。

1. request_api_key を呼び出します。まず status を確認してください — ok はコードが発行されたことを示します。
2. display_to_human ブロックをそのまま人間に表示します。短いコードとリンクが含まれています。 自分でリンクを開かず、住所をでっち上げないでください。
3. 人間がページを開き、コードが一致することを確認してクリックします。ページには住所が一切含まれないキーが表示されます。利用上限を引き上げるため、そこで住所を追加することもできます。
4. poll_api_key を呼び出します（引数は不要です）。approved の場合、キーが一度だけ渡されます。 貼り付け用の config_line も用意されています。IBANFORGE_API_KEY として保存し、再接続してください。

どちらのツールも無料で、無料利用枠を使い切った後も引き続き動作します — これがツールの目的です。

接続して最初の結果を取得する

リモート MCP：インストールもキーも不要

互換性のある MCP クライアントで、Streamable HTTP URL https://api.ibanforge.com/mcp を使用します。 このリモートサービスには、送信元アドレスごとの独自の利用枠があります（無料アクセスを参照）。 バッチ内の各 IBAN は 1 単位としてカウントされます。Authorization: Bearer ifk_... （または X-API-Key）でキーを送信すると、この利用枠ではなく REST API と同様に、そのキーの使用量としてツール呼び出しがカウントされます。URL 内のキーは読み取られません。

Claude Code の場合：

claude mcp add --transport http ibanforge https://api.ibanforge.com/mcp
# with your key:
claude mcp add --transport http ibanforge https://api.ibanforge.com/mcp --header "Authorization: Bearer ifk_your_key"

Claude と Claude Desktop では、カスタムコネクターの作成時に Request headers の下にキーを追加します。 ChatGPT はコネクターにキーを送信しません。そのため、リモートサービスはキーなしの利用枠で引き続き動作します。

「DE89370400440532013000 を検証し、銀行を特定して、結果から証明できることとできないことを説明してください」と尋ねます。valid、bank_code_check、および BIC の出所情報を確認してください。 チェックサムが有効でも、口座の存在や、口座が特定の人物に属することは証明できません。

インストール済み MCP：任意の再利用可能なキーで REST にアクセス

Claude Desktop の場合は、MCP 設定に次の内容を追加します。Cursor の場合は .cursor/mcp.json を使用します。

{
  "mcpServers": {
    "ibanforge": {
      "command": "npx",
      "args": ["-y", "ibanforge-mcp"]
    }
  }
}

Claude Code の場合：

claude mcp add --transport stdio ibanforge -- npx -y ibanforge-mcp

この設定は、プレースホルダーキーなしで動作するよう意図されています。インストール済みパッケージは REST API を呼び出します。キーがない場合、validate_iban はリモート MCP とは別の、キーなしの試用枠を使用します。返された利用制限は必ず確認してください。無料ユーティリティにはそれぞれ独自の保護措置があります。試用枠の終了後、単一 IBAN の検証では 形式のみ が返される場合があり、_degraded: true および _scope: "format_only" と表示されます。銀行、SEPA、コンプライアンスに関する判定は含まれません。拒否されたバッチはエラーを返し、個別の無料リクエストに分割されることはありません。

同じキーを使い続ける

アドレスを指定せずにキーを作成します。

curl -X POST https://api.ibanforge.com/v1/keys/generate

返された api_key を安全に保管し、MCP サーバーの env オブジェクトに IBANFORGE_API_KEY として追加してから、クライアントを再接続します。プレースホルダーキーを貼り付けたり、会話のたびに新しいキーを作成したりしないでください。キーは無料アクセスに記載された利用枠から開始します。一時的な保護によって利用枠が減ることがあるため、monthly_limit を確認してください。キーを使用すると、安定した識別情報、専用のクォータ、および GET /v1/keys/usage が利用できます。

使用した同じキーは、Authorization: Bearer ifk_… を指定して POST /v1/keys/claim で登録できます。キーをリクエスト本文に含めてはいけません。この目的で明示的に指定したアドレスに 6 桁のコードが送信され、それによりキーの利用枠が引き上げられます。利用枠は新しい期間ごとに更新されます。キーを使って x402 で支払うと、利用枠は一度だけ引き上げられ、更新されません。数値はrate-limits.yml の free_tier に記載されています。許可なくアドレスを推測したり、支払いを開始したりしないでください。プリペイドクレジットも設定済みのキーで使用できます。呼び出しごとに 1 クレジット、バッチでは IBAN ごとに 1 クレジットが必要です。

このパッケージにはウォレットがなく、x402 リクエストへの署名や自動支払いは行いません。 API の支払い要件を返します。呼び出しごとの支払いには、支払いガイドに従って x402 対応の HTTP クライアントを使用してください。

推測せずに復旧する

• isError: true：正常なツール結果はありません。error、status、cause、_hint を確認してください。
• 402：既存のキーの cause に従うか、利用可能なキーを設定してください。制限を回避するためにキーを作成しないでください。
• 429：retry_after がある場合は、その時間だけ待機してください。クライアントは HTTP の Retry-After 値を転送します。
• request_timeout / transport_error：完全な応答を受信できませんでした。これは銀行に関する判定ではありません。
• _degraded: true：形式のみが確認されました。銀行や SEPA への到達可能性を示す証拠として使用しないでください。

レスポンス本文の読み取りを含め、リクエストは 30 秒後にタイムアウトします。自動再試行はありません。中断されたアップロードやその他の POST リクエストが、すでに処理されている場合があります。

例

サーバーを追加したら、AI エージェントに次のように尋ねてください。

• 「IBAN DE89 3704 0044 0532 0130 00 を検証して、そのコードを持つ銀行を教えてください」
• 「銀行コード CH93 0076 2011 6238 5295 7 は割り当て済みですか？」（IBAN は mod-97 に合格しますが、SIX の登録簿ではこの銀行コードはどこにも割り当てられていないため、bank_code_check.reason は not_allocated になります）
• 「BIC UBSWCHZH80A を検索してください」
• 「スイスの BC-Nummer 230 を検索してください」
• 「IBAN GB29 NWBK 6016 1331 9268 19 のコンプライアンスチェックを実行してください」
• 「この 5 件の IBAN を一括で検証してください：…」

設定

環境変数	デフォルト	説明
IBANFORGE_API_BASE	https://api.ibanforge.com	セルフホストまたはステージング環境で使用する場合の上書き値
IBANFORGE_API_KEY	(未設定)	実際の Bearer ifk_* キー（任意）。利用可能になるまでは省略してください
IBANFORGE_TIMEOUT_MS	30000	HTTP レスポンス全体の期限。1～120000 ms。無効な値にはデフォルト値が使用されます

データソース

• 銀行コードの判定：このリリースでは、ドイツ（Bundesbank）、オーストリア（OeNB）、ベルギー（NBB）、スロバキア（NBS）、ブルガリア（BNB）、スイスおよびリヒテンシュタイン（SIX BankMaster）の各国登録簿が対象です。登録簿にコードがない場合は not_allocated になります。それ以外の地域では、部分的な登録簿または複合マップが使われるため、コードが見つからなくても拒否を意味しません。最新のリストは llms.txt にあります。
• 121k 件以上の BIC エントリー（機関数ではなく、エントリー数）。GLEIF と各国の登録簿は毎月更新されます。SwiftCodes の行は、2018 年 1 月時点で凍結された SWIFT ディレクトリの公開コピーで、変更せずに再インポートされており、現在もディレクトリの約 3 分の 2 を占めています。最新の正確な件数は api.ibanforge.com/llms.txt をご覧ください。ソース：
  • PeterNotenboom/SwiftCodes（SWIFT ディレクトリの MIT ライセンスの公開コピー。データは 2018 年 1 月時点で凍結）
  • GLEIF の BIC-LEI マッピング（LEI コードを含む唯一の行で、39k 件以上）
  • EBA Clearing STEP2 SCT（公式の SEPA 接続可能 PSP ディレクトリ）
  • Deutsche Bundesbank BLZ（公式の四半期ファイル）
  • NBP EWIB（公式のポーランド銀行登録簿）
  • SIX Group BankMaster（スイスの BIC）
• 公式の SIX BankMaster CSV に基づく 1,100 件以上の BC-Nummern
• EMI／vIBAN の分類：銀行以外の発行者（EMI、決済機関、デジタル銀行）の厳選データと、スペインの銀行コードについては EBA PSD2 登録簿に基づいています。最新の件数は llms.txt で確認できます。
• VoP 対応状況：EPC の Verification of Payee スキーム登録簿（vop.csv）に基づき、その他のコンプライアンスリストとともに毎週更新されます。
• 制裁情報：OFAC、EU、国連のリストに基づき、受取人の銀行（BIC8）と国を照合します。受取人の名前は照合しません。

リンク

• ウェブサイト
• API ドキュメント
• OpenAPI 3.1 仕様
• x402 ディスカバリー
• 課題トラッカー

法的事項

このサーバー経由の呼び出しはホスト型 API にアクセスし、 利用規約（プライバシー、 DPA）が適用されます。検証で確認できるのは IBAN の構造と登録簿のデータであり、 口座が存在することや、誰かに属していることではありません。送金前に、受取人の名前を確認してください。

ライセンス

Apache-2.0