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 tool
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.
Example questions
- What replaced MT103?
- What is the ISO 20022 equivalent of MT940?
- Which payment schemes use pacs.008?
- Is tsin.004 still current?
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.
- "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.
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.