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
| # | Tool | What it does |
|---|---|---|
| 1 | Bank transaction code lookupiso20022_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. |
| 2 | Message details lookupiso20022_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. |
| 3 | Message mapping lookupiso20022_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. |
| 4 | Code set lookupiso20022_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.
| Input | Meaning |
|---|---|
code | A 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). |
PMNTreturns a domain with its families,PMNT-RCDTa family with its subfamilies, andPMNT-RCDT-ESCTthe three official names with a description of the combination.- A code that exists at more than one level, such as
OTHR, is returned once for each level. - The tool covers the ISO external code list. Bank-specific (proprietary) codes are outside it, so a code that is not found may be one of those. A response for a code that is not found lists up to five closest existing codes.
- Codes are matched, not meanings. To find the code for a type of transaction, browse from the domain down.
- Combination descriptions are AI-generated and validated against the official ISO definitions.
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).
| Input | Meaning |
|---|---|
message_id | An 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). |
- The tool covers the standard variant (variant 1) of each message, at the latest version held. A full identifier with another version or variant returns the latest version of the standard variant, with a note that says so.
- Structure figures are counts from the message definition: the total, the maximum depth and the elements at each depth. The element tree is outside the response. The response gives the number of code sets the message uses and names the code sets tool (
next_calls) that lists them. - Counts include every declared element: optional elements and every alternative of a choice sit alongside mandatory ones, so the figures describe the size of the definition, and a single message instance uses a subset of it. The total also counts the two elements at depths 0 and 1 (Document container, message), which the depth counts omit.
- Message descriptions are AI-generated and validated against the official ISO definitions. The Navigator group is a functional grouping the Navigator applies, separate from the ISO 20022 standard.
- A retired message is returned with the data load in which it was retired. A message missing from the dataset returns up to five closest held messages in the same business area; the dataset covers most ISO 20022 messages, so a message absent here may still exist at ISO.
iso20022_legacy_and_scheme_mappings
Answers two kinds of question:
- Which ISO 20022 message replaces a legacy message (SWIFT MT, NACHA, CHAPS legacy), for example MT103 → pacs.008.
- Which payment schemes use an ISO 20022 message, for example the schemes that use pacs.008.
| Input | Meaning |
|---|---|
message | A 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.
- Latest message version only. A version in the input (for example
pacs.008.001.08) maps to its message (pacs.008). - Retired messages are returned with the data load in which they were retired.
- Responses list what the Navigator has recorded. When a mapping is missing, the response says so.
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.
| Input | Meaning |
|---|---|
message | One 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. |
- A code set returns its description, its values (code, name, description) and the messages that use it, with their number (
message_count). A code returns every code set that contains it, with the name and description in each. A message returns the code sets it uses, with their number of values. - Values, code sets and matches arrive as pipe-delimited text with a header row. Long lists come in pages of whole rows; each response states whether the list is complete and the offset to continue from.
- The tool covers the ISO external code sets held in the Navigator. Bank Transaction Codes are served by
iso20022_bank_transaction_codes. - Usage is recorded per message, not per element, so the response shows which messages can use a code set, not where in the message.
- A deactivated value is returned with the data load in which it was deactivated.
- Value descriptions are ISO text. The description of a code set as a whole is AI-generated and validated against the official ISO definitions. The Navigator group is a functional grouping the Navigator applies, separate from the ISO 20022 standard.
Example questions
- What is the ISO 20022 message pacs.008?
- How deep is camt.053, and how are its elements spread across the levels?
- Which of pacs.008 and pacs.009 has the larger message definition?
- What does bank transaction code PMNT-RCDT-ESCT mean?
- Which families does the PMNT domain contain?
- Is OTHR a family or a subfamily?
- What replaced MT103?
- What is the ISO 20022 equivalent of MT940?
- Which payment schemes use pacs.008?
- Is tsin.004 still current?
- What does the code CLBD mean in BalanceType?
- Which code sets does camt.053 use?
- Which messages use the CashAccountType code set?
Connect
Claude (web and desktop app)
- Open Customize → Connectors and choose + Add → Add custom connector.
- Enter a name (for example
ISO 20022 Navigator) and the endpoint URL above. Leave authentication off. - 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
- The assistant answers without using the tool. Some assistants answer from general knowledge unless asked to use a tool. Ask again with "according to the ISO Navigator", or add an instruction to the assistant's project or settings, as described in the README.
- The response says a mapping is not recorded. The Navigator has no recorded mapping for that message. Check the scheme's or SWIFT's own documentation.
- A bank transaction code is not found. The code is not in the ISO external code list. It may be a bank-specific code, and the response lists the closest existing codes.
- "Rate limit reached". The limit is shared by all users. The message states how many seconds to wait before retrying.
- "Temporarily unavailable". The reference database could not be reached. Try again in a minute.
- The connector will not connect. Check the URL for typing errors. A quick availability check is at https://mcp.isonavigator.io/iso20022/health, which shows
okwhen the server is running.
Usage limits
- 600 calls per minute, shared across all users.
- Requests up to 64 KB, and up to 20 requests at the same time.
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.