ISO 20022 Navigator

ISO 20022 Navigator MCP サーバー

ISO 20022 Navigator の参照データを基に、ISO 20022 の金融メッセージについて AI アシスタントに根拠のある回答を提供する MCP サーバーです。

無料で一般公開されています。クライアントに必要なのはエンドポイント URL だけです。

Manish Patel が開発しました · 金融システムの専門家、金融変革・分析

エンドポイント： https://mcp.isonavigator.io/iso20022（Streamable HTTP、オープンアクセス）

ドキュメント · プライバシー · サポート：[email protected]

ツール

すべてのツールは読み取り専用です。

ツール	回答する内容
iso20022_bank_transaction_codes	ISO 20022 の銀行取引コード（ドメイン、ファミリー、サブファミリー）の意味と、ドメインまたはファミリーに属するコードを確認できます。
iso20022_message_details	特定の ISO 20022 メッセージの名称、説明、業務領域、最新バージョン、構造の規模を確認できます。
iso20022_legacy_and_scheme_mappings	旧式メッセージを置き換える ISO 20022 メッセージと、ISO 20022 メッセージを使用する決済スキームを確認できます。
iso20022_code_sets	ISO 20022 の外部コードセットに含まれる内容、各コードの意味、メッセージが使用するコードセットを確認できます。

iso20022_bank_transaction_codes

• 回答内容： 銀行取引明細書や口座報告の項目を分類するドメイン、ファミリー、サブファミリーのコード（例：PMNT-RCDT-ESCT）など、ISO 20022 の銀行取引コードの意味を確認できます。また、ドメインに属するファミリー、ファミリーに属するサブファミリー、コードの使用箇所も表示します。
• 入力： ドメイン・ファミリー・サブファミリーをハイフンでつないだ code。各部分は単独で入力することも、省略することもできます。
  • PMNT：ファミリーを含むドメイン。
  • PMNT-RCDT：サブファミリーを含むドメインとファミリー。
  • PMNT-RCDT-ESCT：3つの名称と説明を含む完全なコード。
  • /RCDT と //ESCT：単独のファミリーまたはサブファミリー（先頭のスラッシュで階層を指定します）。
  • /RCDT/ESCT と PMNT//ESCT：1つの階層を省略した2つの部分。
  • ESCT：階層を指定しない場合、そのコードが存在するすべての階層を返します。
• 返される内容： 正式名称、件数、関連コードの一覧、該当する組み合わせが1つに特定された場合の説明、注記、および provenance ブロックを返します。コードが見つからない場合は、各部分がどこに存在するかを示し、最も近い既存コードを一覧表示します。
• 質問例：
  • 銀行取引コード PMNT-RCDT-ESCT は何を意味しますか？
  • PMNT ドメインにはどのファミリーがありますか？
  • RCDT ファミリーを使用するドメインはどれですか？
  • OTHR はファミリーですか、それともサブファミリーですか？
• 注記：
  • ISO の外部コードリストを対象としています。銀行固有の（独自の）コードは対象外のため、見つからないコードはその一つである可能性があります。
  • 照合するのはコードであり、意味ではありません。取引の種類に対応するコードを探すには、ドメインから順に確認してください。
  • 組み合わせの説明は AI が生成し、ISO の公式定義に照らして検証されています。

iso20022_message_details

• 回答内容： 特定の ISO 20022 メッセージ（例：pacs.008 や camt.053）について、正式名称、平易な英語での説明、属する業務領域とドメイン、最新バージョン、構造の規模と形状を回答します。
• 入力： message_id。4 文字と3桁の数字で構成されます。大文字と小文字は区別されず、ドット、ハイフン、アンダースコア、スペース、または区切りなしの形式を使用できます（pacs.008、PACS-008、pacs008）。pacs.008.001.13 のような完全な識別子も受け付けます。この場合、保持されている最新バージョンについて説明し、相違点があれば記載します。
• 返される内容： メッセージ名、説明、業務領域（コード、名称、ドメイン）、Navigator の機能グループ、最新バージョン、構造の統計情報（要素の総数、最大深度、深度ごとの要素数）、メッセージが使用する外部コードセットの数、一覧を取得する iso20022_code_sets への next_calls ポインター、注記、provenance ブロック。データセットに存在しないメッセージの場合は、その旨を示し、同じ業務領域に属する保持中のメッセージを番号が近い順に最大5件列挙します。
• 質問例：
  • pacs.008 とは何ですか？
  • camt.053 はどの業務領域に属しますか？
  • pain.001 のメッセージ定義の規模はどのくらいですか？
  • camt.099 は現在も有効ですか？
• 注記：
  • 各メッセージの標準バリアント（バリアント1）を、保持されている最新バージョンで扱います。
  • 構造の数値は、メッセージ定義に含まれる要素の数です。要素ツリー自体はこのツールの応答には含まれません。必須要素だけでなく、任意要素と選択肢の各代替要素もすべてカウントされるため、数値は定義全体の規模を表します。1つのメッセージインスタンスでは、その一部のみが使用されます。total_elements には深度0と深度1の2つの要素（Document コンテナとメッセージ）も含まれますが、elements_by_depth には含まれません。
  • 機能グループは Navigator 独自のものであり、ISO 20022 標準とは別のものです。
  • 廃止されたメッセージは、廃止時のデータ読み込みに対応するデータとともに返されます。
  • 説明は AI が生成し、ISO の公式定義と照合して検証されています。

iso20022_legacy_and_scheme_mappings

• 回答内容： どの ISO 20022 メッセージが従来のメッセージ（SWIFT MT、NACHA、CHAPS legacy）に取って代わるか（例：MT103 → pacs.008）、また、どの決済スキームが ISO 20022 メッセージを使用するかを回答します。
• 入力： message（MT103、940、pacs.008 などの従来形式または ISO 20022 のメッセージ）と、任意の standard（SEPA など、回答を1つの標準またはスキームに絞り込みます）。
• 返される内容： ステータス、スキームでの使用状況、注記、provenance ブロックを含む、メッセージ単位のマッピング。
• 質問例：
  • MT103 に取って代わったものは何ですか？
  • MT940 に相当する ISO 20022 メッセージは何ですか？
  • pacs.008 を使用する決済スキームはどれですか？
  • tsin.004 は現在も有効ですか？
• 注記：
  • 最新のメッセージバージョンのみを扱います。入力にバージョン（例：pacs.008.001.08）が含まれる場合は、そのメッセージ（pacs.008）に対応付けられます。
  • 廃止されたメッセージは、廃止時のデータ読み込みに対応するデータとともに返されます。
  • 応答には Navigator が記録している内容が列挙されます。マッピングが存在しない場合は、その旨を示し、記録されたデータに基づいて回答するようアシスタントに案内します。

iso20022_code_sets

• 回答内容： ISO 20022 の外部コードセットに含まれる内容（例：BalanceType）、CLBD などのコードの意味、コードが特定のセットに属しているかどうか、メッセージが使用するコードセット、コードセットを使用するメッセージについて回答します。
• 入力： message（BalanceType や ExternalBalanceType1Code などのコードセット、CLBD などのコード、または camt.053 などの ISO 20022 メッセージ）、任意の code（コードセット内の値を 1 つ確認します）、任意の offset（長いリストの続きを取得します）。
• 返される内容： コードセットの場合は、詳細、その値（コード、名前、説明）、およびそのセットを使用するメッセージとその件数（message_count）が返されます。コードの場合は、そのコードを含むすべてのコードセットが返されます。メッセージの場合は、そのメッセージが使用するコードセットと、それぞれの値の件数が返されます。リストはヘッダー行付きのパイプ区切りテキストで返されます。長いリストはページに分割され、各応答にはリストが完了しているかどうかと、続きの取得に使う next_offset が示されます。
• 質問例：
  • BalanceType コードセットにはどのようなコードが含まれていますか？
  • CLBD は有効な残高タイプコードですか？
  • ISO 20022 のコード OTHR は何を意味しますか？
  • camt.053 はどのコードセットを使用しますか？
• 注記：
  • 銀行取引コードの値は iso20022_bank_transaction_codes によって提供されます。
  • コードセットとメッセージの関連付けはメッセージ単位で記録されており、要素単位の情報はデータに含まれていません。
  • 無効化された値は、無効化された時点のデータ読み込み分とともに返されます。
  • コードセットの説明（concept_description）は AI が生成したものです。値の説明は ISO のテキストです。
  • navigator_group は Navigator 独自のコードセットのグループ分けであり、ISO の分類とは異なります。

アシスタントにこのツールを使わせる

ツールを使うように指示されない限り、アシスタントによっては一般知識から回答します。この判断はアシスタントが行います。プロジェクトの指示に次の行を追加すると、該当する場合にアシスタントがツールを使いやすくなります。

ISO 20022 の銀行取引コード、メッセージ、その旧形式の同等規格（SWIFT MT、NACHA）、あるメッセージを使用する決済スキーム、外部コードセットやコードの意味、またはメッセージが使用するコードセットに関する質問には、まず ISO Navigator コネクターを呼び出し、そのデータに基づいて回答してください。

ほかのアシスタントでは動作が異なる場合があります。ツールの呼び出しなしで回答された場合は、「ISO Navigator によると」と付けてもう一度質問してください。

利用制限

• 共有レート制限。 全ユーザー合計で、1 分あたり 600 回までです。上限に達すると、再試行までの待ち時間が応答に示されます。
• リクエストサイズ。 最大 64 KB のリクエストを受け付け、サーバーは同時に最大 20 件のリクエストを処理します。

データ

すべての応答には provenance ブロックが含まれます。その data_baseline（例：4Q2025）は、Navigator のベースラインデータの読み込み四半期を示します。これはデータが Navigator に追加された時期を表すもので、ISO 20022 の公開日とは異なります。移行日を確認する際は、スキームまたは SWIFT の最新の公式ドキュメントを参照してください。

Navigator は世界の決済スキームの一部を記録しており、すべてを網羅しているわけではありません。対象となる規格は、SWIFT MT、SEPA、CIPS、NACHA / ACH、AFT、Lynx、RTR、CHAPS、Elixir、iDEAL、SIC、Bankgirot、NPP、MEPS+、RENTAS、BAHTNET です。T2、FedNow、Fedwire など、この一覧にないスキームについては、記録されたマッピングがないため、応答に表示されません。

説明の一部は AI が生成したものです。本番環境で使用する前に、ISO 20022 およびスキームの公式ドキュメントで確認してください。

接続

上記のエンドポイント URL を使用してください。メニュー名はリリースによって変わります。以下のラベルが画面に表示されているものと異なる場合は、クライアント自身の MCP ドキュメントを参照してください。

Claude（ウェブ版およびデスクトップアプリ）

1. Customize → Connectors を開き、+ Add → Add custom connector を選択します。
2. 名前（例：ISO 20022 Navigator）とエンドポイント URL を入力します。認証はオフのままにします。
3. チャットで左下の + ボタンを押し、Connectors を選択して、コネクターをオンにします。

Team プランおよび Enterprise プランでは、オーナーがまず Organization settings → Connectors → Add → Custom → Web から追加します。 その後、メンバーは Customize → Connectors から接続できます。Free プランで利用できるカスタムコネクターは 1 つです。 詳しくはAnthropic のガイドをご覧ください。

Claude Code

claude mcp add --transport http iso20022 https://mcp.isonavigator.io/iso20022

claude mcp list を実行するか、Claude Code 内で /mcp を実行して確認します。すべてのプロジェクトで利用できるようにするには、--scope user を追加します。

GitHub Copilot を使用する VS Code

1. コマンドパレットから MCP: Open User Configuration を実行します（またはプロジェクト内に .vscode/mcp.json を作成します）。

2. 次を追加します。

   {
     "servers": {
       "iso20022": {
         "type": "http",
         "url": "https://mcp.isonavigator.io/iso20022"
       }
     }
   }
   

3. MCP: List Servers を実行し、iso20022 を選択して起動します（または再起動します）。

4. Copilot Chat で Agent モードを使用します。ツールの一覧にツールが表示されます。

Cursor

~/.cursor/mcp.json（すべてのプロジェクト）または .cursor/mcp.json（1 つのプロジェクト）に追加します。

{
  "mcpServers": {
    "iso20022": {
      "url": "https://mcp.isonavigator.io/iso20022"
    }
  }
}

チャットのツール一覧から、ツールをオンまたはオフにできます。

ChatGPT

カスタム MCP コネクターを使用するには開発者モードが必要で、ウェブ版で利用できます。利用可能かどうかはプランによって異なります。詳しくは OpenAI のガイドをご覧ください。 手順は次のとおりです。Settings → Apps → Advanced settings で開発者モードをオンにし、Create を選択して、エンドポイント URL を入力します。 認証はオフのままにし、Scan Tools、続いて Create を選択します。このサーバーはデータを読み取るため、読み取り専用アクセスで十分です。

Codex CLI

codex mcp add iso20022 --url https://mcp.isonavigator.io/iso20022

この操作により、サーバーが ~/.codex/config.toml に保存されます。または、自分でこのファイルに追加します（信頼済みプロジェクト 1 つの場合は .codex/config.toml）。

[mcp_servers.iso20022]
url = "https://mcp.isonavigator.io/iso20022"

codex mcp list を実行するか、Codex セッション内で /mcp を実行して確認します。

Gemini CLI

gemini mcp add --transport http iso20022 https://mcp.isonavigator.io/iso20022

すべてのプロジェクトで利用できるようにするには --scope user を追加します。デフォルトでは、現在のプロジェクトのみで利用できます。または、~/.gemini/settings.json（1 つのプロジェクトの場合は .gemini/settings.json）に追加します。

{
  "mcpServers": {
    "iso20022": {
      "httpUrl": "https://mcp.isonavigator.io/iso20022"
    }
  }
}

SSE サーバー用の url ではなく、httpUrl を使用してください。gemini mcp list を実行するか、セッション内で /mcp を実行して確認します。Gemini CLI が受け付ける Google アカウントまたは API キーは Google によって定められており、変更されている場合があります。起動しない場合は、Google の最新ドキュメントをご確認ください。

その他の MCP クライアント

Streamable HTTP を使用したリモート MCP サーバーに対応するクライアントであれば、エンドポイント URL を利用できます。データベースに依存しない ヘルスチェックは https://mcp.isonavigator.io/iso20022/health で利用できます。

ローカルで実行する

Python 3.14 と Navigator データベース（非公開）へのアクセスが必要です。

python -m venv .venv
.venv\Scripts\activate            # Windows; on macOS/Linux: source .venv/bin/activate
pip install -r requirements.txt

接続文字列を .env ファイルに DATABASE_URL=... として記述し、次のいずれかを実行します。

• python server.py — Claude Desktop または MCP Inspector 用の stdio トランスポート
• MCP_TRANSPORT=http を設定してから python server.py を実行 — デプロイ時と同じ HTTP トランスポート。アドレスは http://localhost:8000/iso20022（ヘルスチェック：/iso20022/health）です

その他の設定については、server.py の冒頭をご覧ください。

テスト

pip install -r requirements-dev.txt
bandit -q -r . -x ./tests,./.venv
ruff check .
python -m pytest -q

DATABASE_URL が設定されている場合、データベースのテストが実行されます。

ライセンス

コードはMIT Licenseの下で公開されています。ツールが提供する参照データはこのリポジトリの外部にあり、そのライセンスも別途定められています。