sebastienrousseau/camt053-mcp

[![PyPI Version][pypi-badge]][07]
[![Python Versions][python-versions-badge]][07]
[![License][license-badge]][01]
[![Tests][tests-badge]][tests-url]
[![Quality][quality-badge]][quality-url]
[![OpenSSF Scorecard][scorecard-badge]][scorecard-url]
[![OpenSSF Best Practices][bestpractices-badge]][bestpractices-url]
[![Documentation][docs-badge]][docs-url]
**A [Model Context Protocol][mcp] server that exposes the [camt053][core]
ISO 20022 Bank Statement library as tools for AI agents and assistants** —
discover message types and return reasons, inspect input schemas, validate
records and financial identifiers, parse incoming statements, and generate
validated reversing-entry XML, all from your favourite MCP client.
> **Latest release: v0.0.22**: Multi-framework agent adapters (LangChain, CrewAI, LlamaIndex), OAuth 2.1 resource-server auth (RFC 9728)
> on the HTTP transport, Prometheus metrics, a tamper-evident audit chain,
> and real-HTTP load benchmarks; 24 MCP tools over stdio, streamable HTTP,
> SSE or authenticated streamable HTTP, all backed by the shared
> camt053.services layer,
> for Python 3.10+.
> [See what's new →][release-0014]
Contents
- Overview
- The ISO 20022 MCP Suite
- Install
- Quick Start
- Transports — stdio, streamable HTTP (2026-07-28 and 2025-11-25), SSE and authenticated HTTP from one command line
- Tools
- Prompts
- Resources
- Rulebook search
- Using the tools
- The camt053 suite
- When not to use camt053-mcp
- Development
- Security
- Documentation
- License
- Contributing
- Acknowledgements
Overview
The [Model Context Protocol][mcp] (MCP) is an open standard that lets AI agents
and assistants discover and call external tools in a uniform way. **camt053-mcp**
is an MCP server that turns the [camt053][core] library into a set of
first-class agent tools, so an assistant can read and reverse **ISO 20022
camt.05x cash-management messages** — the standardised bank-to-customer
account reports, statements, and debit/credit notifications — directly from a
conversation.
The headline capability is the one-shot reversing-entry workflow: read an
incoming camt.053 statement, find the entries carrying a return reason code
(e.g. AC04 Closed Account), and emit a validated reversing entry.
Every tool is a thin, typed wrapper over camt053.services — the single shared
facade also used by the CLI and REST API — so all interfaces behave identically.
Tools return JSON-serialisable data; on an error they return an
{"error": ...} payload rather than raising.
- **Website:**
- **Source code:**
- **Bug reports:**
This package is part of the **camt053 suite** — a set of independently
installable packages that share the camt053.services layer:
- [camt053][core] — the core library (CLI + REST API)
- camt053-mcp — this package, the **Model Context Protocol** server
- [camt053-lsp][lsp] — the **Language Server Protocol** server for editors
The ISO 20022 MCP Suite
camt053-mcp is the **bank-statement flagship** of eight coordinated,
vendor-neutral MCP servers that together cover the ISO 20022
bank-statement workflow and the November 2026 structured-address
cutover — statement depth, whole-catalogue routing, reconciliation,
multi-format ingestion, and address remediation. Dependency ranges are kept
aligned across the suite, so the servers co-install cleanly in a single
Python environment: start with one, add the rest as your workflow grows.
| Server | Scope | Surface | Install | Use it when |
|------|------|------|------|------|
| camt053-mcp | ISO 20022 camt.053/camt.052 bank statements: parse, validate, filter, reverse; MT940/MT942 migration; CBPR+ readiness; journal export | 24 MCP tools · 4 prompts · 3 resources | pip install camt053-mcp | You work with bank-to-customer statements end to end — **this package**, the suite's flagship |
| iso20022-mcp | Unified gateway: search / describe / validate / generate / parse meta-tools routed across the pain · pacs · camt · acmt families | 7 meta-tools | pip install "iso20022-mcp[all]" | You want one entry point to every message family |
| reconcile-mcp | Matches expected pain.001 payments against observed camt.053 entries — exact, partial, one-to-many, many-to-one, every match scored and explained | 7 MCP tools | pip install reconcile-mcp | You need explainable statement/payment reconciliation |
| structured-address-fix-mcp | ISO 20022 postal-address classification, assessment & remediation for the November 2026 structured-address cutover, plus a high-level orchestration layer — readiness scoring, clearing-profile linting, and audit evidence (pacs.008 / pain.001 debtor & creditor addresses) | 9 MCP tools | pip install structured-address-fix-mcp | You need debtor/creditor addresses cliff-ready ahead of 14 Nov 2026 |