ISO 20022 MCP Suite — documentation.
Get in touch ›
Aerial view of illuminated financial district at night

ISO 20022 MCP Suite — documentation.

Install in one line, make your first validated ISO 20022 message in under a minute, and pick the right server for the job. Vendor-neutral, runs anywhere.

The ISO 20022 MCP Suite is the open bank-message layer for AI agents: eight vendor-neutral servers to generate, validate, reconcile and settle ISO 20022 payments from natural language. Everything below gets you from nothing to a validated message in under a minute — no account, no key, no lock-in.

60-SECOND QUICKSTART

Install one line, send one message.

Run the gateway with no install and no account. It routes to whichever server the job needs.

  • 1 · Run it. uvx --from "iso20022-mcp[all]" iso20022-mcp — or add it to your MCP client (Claude Desktop, Cursor) as the command iso20022-mcp.
  • 2 · Find the message. Ask search "cancel a payment" → the gateway points you at camt.056 and the camt-exceptions server.
  • 3 · Generate it. Ask generate camt.056 with the payment details → you get back XSD-validated ISO 20022 XML. Done.

WHICH SERVER DO I NEED?

One job, one server.

Install the gateway and let it route, or install just the one for the task in front of you. Every server is pip install-able and live on the official MCP registry.

Full tool reference for every server · End-to-end recipes

SAFE BY DESIGN

Built to hand to an agent.

  • Validated before return. Every generator checks its output against the official bundled XSD before it hands it back — malformed messages never leave the tool.
  • Never moves money. The AP2/x402 bridge only transforms and validates; producing a message is deliberately separate from sending it, so the money-movement step stays a human-guarded action.
  • Read-only where it counts. Reconciliation is pure matching; every tool is marked read-only, idempotent and closed-world so clients can reason about safety.
  • Provenance you can audit. Bundled schemas are the official ISO 20022 XSDs; every server is Apache-2.0 at 100% branch-test coverage, on PyPI and the official MCP registry.

THE 2026–2028 MIGRATION

Move off MT, one message at a time.

MT/MX coexistence ended in November 2025; MT retires through 2028, and structured postal addresses become mandatory in November 2026. The suite ships the tools for exactly this.

  • MT → MX converters. convert_mt103 → pacs.008, convert_mt101 → pain.001, convert_mt940/convert_mt942 → camt — validated output, wired into the servers.
  • Structured-address toolkit. classify / validate-by-policy / repair / batch, in pacs008-mcp, for the November 2026 cliff.
  • Exceptions ready. pacs.004 returns and pacs.002 status in pacs008-mcp; camt.056 cancellation and camt.029 resolution in camt-exceptions.

OPEN SOURCE · APACHE-2.0 · ON PYPI + THE MCP REGISTRY

Back to the suite.

Eight servers, the whole ISO 20022 payment lifecycle, installable in one line.

Explore the suite · Tool reference