ISO 20022 Navigator MCP server

Grounded answers about ISO 20022 messages, bank transaction codes, code sets and message mappings, for AI assistants. Free and public.

Built by Manish Patel · Financial Systems Expert, Finance Transformation & Analytics

What it is

An MCP server that lets AI assistants look up reference data from the ISO 20022 Navigator. Instead of answering from memory, the assistant calls the server and answers from the recorded data. The server is read-only, and the endpoint URL is all a client needs.

Endpoint: https://mcp.isonavigator.io/iso20022 (Streamable HTTP, open access)

The four tools at a glance

#ToolWhat it does
1Bank transaction code lookup
iso20022_bank_transaction_codes
Explains what an ISO 20022 Bank Transaction Code (domain, family, subfamily) means, for example PMNT-RCDT-ESCT, and shows which families sit under a domain and which subfamilies under a family.
2Message details lookup
iso20022_message_details
Shows what an ISO 20022 message is, for example pacs.008 or camt.053: its official name, business area, latest version held and description, plus the size of its definition.
3Message mapping lookup
iso20022_legacy_and_scheme_mappings
Finds which ISO 20022 message replaces a legacy message (SWIFT MT, NACHA, CHAPS legacy), for example MT103 to pacs.008, and which payment schemes use an ISO 20022 message.
4Code set lookup
iso20022_code_sets
Shows the values of an ISO 20022 external code set, what a code such as CLBD means, which code sets contain a code, and which code sets a message uses.

Tool details

iso20022_bank_transaction_codes

Explains what an ISO 20022 Bank Transaction Code means: the domain, family and subfamily codes that classify entries in bank statements and account reports, for example PMNT-RCDT-ESCT. It also shows which families sit under a domain, which subfamilies under a family, and where a code appears.

InputMeaning
codeA Bank Transaction Code or part of one, written domain-family-subfamily with hyphens, such as PMNT-RCDT-ESCT. Leading slashes fix the level (/RCDT is a family, //ESCT is a subfamily), and an empty level is skipped (PMNT//ESCT).

iso20022_message_details

Shows what an ISO 20022 message is, for example pacs.008 or camt.053: its official name, business area, latest version held and description, plus the size of its definition (element counts by depth and the number of code sets).

InputMeaning
message_idAn ISO 20022 message identifier such as pacs.008 or camt.053, in any case, written with or without a separator (dot, hyphen, underscore or space). A full identifier such as pacs.008.001.13 is accepted too (7 to 24 characters).

iso20022_legacy_and_scheme_mappings

Answers two kinds of question:

InputMeaning
messageA legacy or ISO 20022 message, such as MT103, 940 or pacs.008.
standard (optional)Narrows the answer to one standard or scheme, such as SEPA.

The response lists message-level mappings with status, scheme usage, notes and a provenance block that names the source and the data baseline.

iso20022_code_sets

Shows the values of an ISO 20022 external code set, for example BalanceType or ReturnReason, what a code such as CLBD means, which code sets contain a code, which code sets a message such as camt.053 uses, and which messages use a code set.

InputMeaning
messageOne identifier: a code set (BalanceType, or its full name ExternalBalanceType1Code), a code (CLBD, OTHR) or an ISO 20022 message (camt.053, pacs.008.001.08), up to 60 characters.
code (optional)A single value to check when message is a code set, such as CLBD in BalanceType (up to 10 characters).
offset (optional)The row to continue from, used only when a previous response says the list is not complete.

Example questions

Connect

Claude (web and desktop app)

  1. Open Customize → Connectors and choose + Add → Add custom connector.
  2. Enter a name (for example ISO 20022 Navigator) and the endpoint URL above. Leave authentication off.
  3. In a chat, use the + button at the lower left, then Connectors, and switch the connector on.

Steps for Claude Code, VS Code with GitHub Copilot, Cursor, ChatGPT and other MCP clients are in the README on GitHub.

Troubleshooting

Usage limits

Scheme coverage

The Navigator records a selection of the world's payment schemes, not all of them. The standards covered are SWIFT MT, SEPA, CIPS, NACHA / ACH, AFT, Lynx, RTR, CHAPS, Elixir, iDEAL, SIC, Bankgirot, NPP, MEPS+, RENTAS and BAHTNET. A scheme not on this list, such as T2, FedNow or Fedwire, has no recorded mappings, so the response will not list it.

Data and accuracy

Every response carries a provenance block. Its data_baseline (for example 4Q2025) is the quarter of the Navigator's baseline data load, which marks when the data was added to the Navigator and differs from any ISO 20022 publication date.

Some explanations are AI-generated. Verify against official ISO 20022 and scheme documentation before use in production.