Camt053 MCP

What sebastienrousseau/camt053-mcp MCP server does

The sebastienrousseau/camt053-mcp MCP server turns the camt053 ISO 20022 bank-statement library into MCP tools for AI clients. It works with camt.05x messages, including camt.053 statements and camt.052 reports produced through MT942 conversion. Inputs and outputs are handled in memory: statement XML and legacy MT text are supplied as strings, while parsed documents, validation reports, journal payloads, and generated XML are returned to the caller.

The main reversal workflow accepts an incoming statement and an ISO return-reason code, selects matching entries, and produces a validated camt.053.001.14 reversal document. Supporting tools let an agent discover valid message types and reason codes, inspect schemas, validate records, and preview entries before generating a reversal.

How it works

Tools are exposed through MCP and delegate to the shared camt053 service layer. Parsing produces a structured document containing the group header, statements, accounts, balances, and entries. Flat entry-list tools provide filtering and optional pagination, while anomaly detection applies fixed rules for duplicate references, unusually large fee deductions, and transaction-count spikes.

Validation operates at different levels. Record validation checks flat input data against a message-type JSON Schema. Statement validation checks XML against the matching ISO 20022 XSD. The CBPR+ readiness check separately evaluates supported camt.053 schema revisions and postal-address structure for the November 2026 acceptance rules.

Rulebook search is limited to a curated, offline registry covering SEPA, CBPR+, and HVPS+ clauses. Its vector search uses deterministic lexical vectors rather than a hosted embedding service. Entry classification is different: classify_entry uses MCP Sampling to ask the connected client to perform an LLM completion, so clients without Sampling cannot use that tool.

Setup and configuration

Install the package with pip and launch the executable over the default stdio transport:

python -m pip install camt053-mcp
camt053-mcp

The package requires Python 3.10 or newer and runs on macOS, Linux, and Windows. A client configuration can register camt053-mcp as a stdio MCP server. The optional vector extra enables rulebook similarity search; without it, that tool returns an error directing the operator to install the extra.

Tools and capabilities

The sebastienrousseau/camt053-mcp MCP server includes capabilities for:

• Discovering supported camt message types, return reasons, required fields, and complete input schemas.
• Parsing camt.05x XML and converting MT940 or MT942 text into compatible structured documents.
• Validating identifiers, records, XML/XSD conformance, and CBPR+ readiness.
• Listing, paginating, filtering, classifying, and screening statement entries for anomalies.
• Generating reversal XML for selected return reasons.
• Creating Xero BankTransactions or QuickBooks Online JournalEntry payloads without calling either platform.
• Browsing, searching, and citing curated SEPA, CBPR+, and HVPS+ rulebook clauses.

Journal exports contain operator-fill placeholders for values such as account codes, contacts, and realm identifiers. The tool prepares payloads but does not post them to an accounting API.

Limitations and notes

The server does not write generated documents to disk or make external accounting-platform API calls. Rulebook citations are summaries with source URLs, not authoritative reproductions of the underlying rulebooks. MT942 data that has no dedicated field in the camt.053-oriented model is surfaced through documented proprietary balance type codes.

The HTTP transport supports OAuth 2.1 resource-server authentication according to the repository material, while local stdio usage is the straightforward installation path. The CBPR+ readiness tool reports the cutover date as 2026-11-16 and checks the rules represented by the server; it is not a general certification of every clearing-system requirement.