ISO 20022 Navigator MCP server

An MCP server that gives AI assistants grounded answers about ISO 20022 financial messaging, from the reference data behind the ISO 20022 Navigator.

Status: in development. A public endpoint is not available yet.

Tools

All tools are read-only.

Related MCP server: mcp-iso

Run locally

Requires Python 3.14 and access to the Navigator database (not public).

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

Put the connection string in a .env file as DATABASE_URL=..., then either:

• python server.py — stdio transport, for Claude Desktop or MCP Inspector

• set MCP_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.

Tests

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

Database tests are skipped when no DATABASE_URL is available.

License

The code is under the MIT License. The reference data served by the tools is not part of this repository and is not covered by that license.