
MCP Server for ISO 20022 Navigator tools
MCP Server for ISO 20022 Navigator tools
·
An MCP server that gives AI assistants grounded answers about ISO 20022 financial messaging, from the reference data behind the ISO 20022 Navigator.
Free and public. The endpoint URL is all a client needs.
Built by Manish Patel · Financial Systems Expert, Finance Transformation & Analytics
Endpoint: https://mcp.isonavigator.io/iso20022 (Streamable HTTP, open access)
Documentation · Privacy · Support: [email protected]
All tools are read-only.
| Tool | What it answers |
|---|---|
iso20022_bank_transaction_codes | What an ISO 20022 Bank Transaction Code (domain, family, subfamily) means, and which codes exist under a domain or family. |
iso20022_message_details | What a specific ISO 20022 message is: its name, description, business area, latest version and structure size. |
iso20022_legacy_and_scheme_mappings | Which ISO 20022 message replaces a legacy message, and which payment schemes use an ISO 20022 message. |
iso20022_code_sets | What an ISO 20022 external code set contains, what a code means, and which code sets a message uses. |
iso20022_bank_transaction_codesPMNT-RCDT-ESCT. It also shows which families sit under a domain, which subfamilies under a family, and where a code appears.code, written domain-family-subfamily with hyphens. Any part can stand alone or be skipped:
PMNT: a domain, with its families.PMNT-RCDT: a domain and family, with the subfamilies.PMNT-RCDT-ESCT: a full code, with the three names and a description./RCDT and //ESCT: a family or a subfamily on its own (the leading slashes fix the level)./RCDT/ESCT and PMNT//ESCT: two parts with one level skipped.ESCT: no level given; every level where the code exists is returned.provenance block. A code that is not found says where each part exists and lists the closest existing codes.iso20022_message_detailspacs.008 or camt.053: its official name, a plain-English description, the business area and domain it belongs to, its latest version and the size and shape of its structure.message_id, four letters and three digits. Any case works, and a dot, hyphen, underscore, space or a bare join all work (pacs.008, PACS-008, pacs008). A full identifier such as pacs.008.001.13 is accepted too; the response describes the latest version held and notes any difference.next_calls pointer to iso20022_code_sets for the list, notes and a provenance block. A message that is missing from the dataset says so and lists up to five held messages in the same business area, nearest number first.total_elements also counts the two elements at depths 0 and 1 (Document container, message), which elements_by_depth omits.iso20022_legacy_and_scheme_mappingsmessage (a legacy or ISO 20022 message, such as MT103, 940 or pacs.008) and an optional standard (narrows the answer to one standard or scheme, such as SEPA).provenance block.pacs.008.001.08) maps to its message (pacs.008).iso20022_code_setsBalanceType), what a code such as CLBD means, whether a code belongs to a set, which code sets a message uses, and which messages use a code set.message (a code set such as BalanceType or ExternalBalanceType1Code, a code such as CLBD, or an ISO 20022 message such as camt.053), an optional code (checks one value in the code set) and an optional offset (continues a long list).message_count). For a code, every code set that holds it. For a message, its code sets with their number of values. Lists arrive as pipe-delimited text with a header row. Long lists come in pages; each response states whether the list is complete and the next_offset to continue.iso20022_bank_transaction_codes.concept_description) are AI-generated. Value descriptions are ISO text.navigator_group is the Navigator's own grouping of code sets, which differs from an ISO classification.Some assistants answer from general knowledge unless asked to use a tool, a choice made by the assistant. Adding the following line to a Project's instructions helps the assistant use the tools where they apply:
For any question about ISO 20022 bank transaction codes, messages, their legacy equivalents (SWIFT MT, NACHA), which payment schemes use a message, what an external code set or code means, or which code sets a message uses, call the ISO Navigator connector first and answer from its data.
Other assistants may behave differently. If an answer comes without a tool call, ask again with "according to the ISO Navigator".
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. Check the scheme's or SWIFT's own current documentation before relying on a migration date.
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.
Some explanations are AI-generated. Verify against official ISO 20022 and scheme documentation before use in production.
Use the endpoint URL above. Menu names change between releases; if a label below differs from what you see, the client's own MCP documentation is the reference.
ISO 20022 Navigator) and the endpoint URL. Leave authentication off.On Team and Enterprise plans an owner first adds it under Organization settings → Connectors → Add → Custom → Web; members then connect it from Customize → Connectors. The Free plan allows one custom connector. See Anthropic's guide.
claude mcp add --transport http iso20022 https://mcp.isonavigator.io/iso20022Check it with claude mcp list, or /mcp inside Claude Code. Add --scope user to make it available in every project.
Run MCP: Open User Configuration from the Command Palette (or create .vscode/mcp.json in a project).
Add:
{
"servers": {
"iso20022": {
"type": "http",
"url": "https://mcp.isonavigator.io/iso20022"
}
}
}Run MCP: List Servers, select iso20022 and start (or restart) it.
Use Copilot Chat in Agent mode; the tools appear in the tools list.
Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):
{
"mcpServers": {
"iso20022": {
"url": "https://mcp.isonavigator.io/iso20022"
}
}
}Tools can be switched on and off from the chat's tools list.
Custom MCP connectors need developer mode and are available on the web. Availability depends on your plan; see OpenAI's guide. In short: turn on developer mode under Settings → Apps → Advanced settings, choose Create, enter the endpoint URL and leave authentication off, select Scan Tools, then Create. This server reads data, so read-only access is enough.
codex mcp add iso20022 --url https://mcp.isonavigator.io/iso20022This saves the server to ~/.codex/config.toml. Or add it there yourself (.codex/config.toml for one trusted project):
[mcp_servers.iso20022]
url = "https://mcp.isonavigator.io/iso20022"Check it with codex mcp list, or /mcp inside a Codex session.
gemini mcp add --transport http iso20022 https://mcp.isonavigator.io/iso20022Add --scope user to make it available in every project; the default is the current project only. Or add it to ~/.gemini/settings.json (.gemini/settings.json for one project):
{
"mcpServers": {
"iso20022": {
"httpUrl": "https://mcp.isonavigator.io/iso20022"
}
}
}Use httpUrl, not url, which is for SSE servers. Check it with gemini mcp list, or /mcp inside a session. Which Google accounts or API keys Gemini CLI accepts is set by Google and has changed; check Google's current documentation if it will not start.
Any client that supports remote MCP servers over Streamable HTTP can use the endpoint URL. A database-independent
health check is at https://mcp.isonavigator.io/iso20022/health.
Requires Python 3.14 and access to the Navigator database (private).
python -m venv .venv
.venv\Scripts\activate # Windows; on macOS/Linux: source .venv/bin/activate
pip install -r requirements.txtPut the connection string in a .env file as DATABASE_URL=..., then either:
python server.py — stdio transport, for Claude Desktop or MCP InspectorMCP_TRANSPORT=http, then python server.py — HTTP transport as deployed, at
http://localhost:8000/iso20022 (health check: /iso20022/health)See the top of server.py for the other settings.
pip install -r requirements-dev.txt
bandit -q -r . -x ./tests,./.venv
ruff check .
python -m pytest -qDatabase tests run when DATABASE_URL is available.
The code is under the MIT License. The reference data served by the tools sits outside this repository and its license.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add iso20022 --transport http https://mcp.isonavigator.io/iso20022{
"mcpServers": {
"iso20022": {
"url": "https://mcp.isonavigator.io/iso20022",
"type": "http"
}
}
}code --add-mcp '{"name":"iso20022","url":"https://mcp.isonavigator.io/iso20022","type":"http"}'Runs as a hosted service. Your client connects over the network and nothing is installed locally.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/iso-20022-navigator-mcp-server to learn what the "ISO 20022 Navigator MCP server" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
claude mcp add --transport http iso20022 https://mcp.isonavigator.io/iso20022| Name | What it does |
|---|---|
iso20022_bank_transaction_codes | Use for ANY question about ISO 20022 Bank Transaction Codes (BTC): the Domain / Family / SubFamily codes that classify entries in bank statements and account reports, such as PMNT, PMNT-RCDT or PMNT-R |
iso20022_message_details | Use for ANY question about what an ISO 20022 message is: its official name, purpose, business area, latest version, and the size and shape of its structure. Send a message identifier such as pacs.008, |
iso20022_legacy_and_scheme_mappings | Use for ANY question about what replaces or corresponds to a legacy payment message (SWIFT MT such as MT103, MT202, MT940; NACHA; CHAPS), or which payment schemes use an ISO 20022 message (pacs.008, p |
iso20022_code_sets | Use for ANY question about ISO 20022 external code sets: the values of a code set (BalanceType, ReturnReason, Purpose, StatusReason, ...), what a code means (CLBD, OTHR, ...), whether a code is valid |
Read live from the server on November 15, 2026.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/iso-20022-navigator-mcp-server)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "iso-20022-navigator-mcp-server" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.