Bankstatementparser MCP

bankstatementparser-mcp

Model Context Protocol server exposing the bankstatementparser library as first-class agent tools for reading bank statements.

---

Contents

Getting started

• What is bankstatementparser-mcp? — the problem it solves
• The ISO 20022 MCP Suite — the four coordinated servers and when to use each
• Install — PyPI, virtualenv, Docker
• Quick start — register with Claude Desktop in 30 seconds
• Transports — stdio, streamable HTTP (2026-07-28 and 2025-11-25) and SSE from one command line

Library reference

• Tools — the five tools, one resource, one prompt
• Using the tools — call them in-process from Python

Operational

• When not to use bankstatementparser-mcp — honest boundaries
• Development — gates, make targets
• Security — sandboxing posture
• Documentation — examples, guides
• Contributing — how to get changes in
• License — Apache-2.0

---

What is bankstatementparser-mcp?

The Model Context Protocol (MCP) is an open standard that lets AI agents discover and call external tools in a uniform way. bankstatementparser-mcp is the MCP server that turns the bankstatementparser library into first-class agent tools — so an assistant can read, validate, and summarise bank statements in formats such as ISO 20022 CAMT.053, SWIFT MT940, OFX/QFX, and CSV directly from a conversation.

Every tool is a thin wrapper over the bankstatementparser parser core (create_parser, detect_statement_format), so the results behave identically to the CLI. Because an MCP client does not share the server's filesystem, the tools take inline statement content (plus a filename hint) and materialise it in a private temporary file for the duration of a single call. Tools return JSON-serialisable data.

---

The ISO 20022 MCP Suite

bankstatementparser-mcp is the ingestion layer 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.

In one line each: `camt053-mcp` is the bank-statement flagship (deepest camt.05x surface, stdio + authenticated streamable HTTP); `iso20022-mcp` is the generic message toolkit (a handful of verbs over the whole catalogue); `reconcile-mcp` is the reconciliation workflow (did the money we expected actually arrive?); `bankstatementparser-mcp` is the ingestion layer (many formats in, one transaction shape out); and `structured-address-fix-mcp` is the postal-address specialist (debtor/creditor addresses cliff-ready for the Nov 2026 cutover).

---

Install

Requires Python 3.10 or later. Works on macOS, Linux, and Windows.

Using an isolated virtual environment (recommended)

python -m venv venv

source venv/bin/activate # macOS/Linux venv\Scripts\activate # Windows python -m pip install -U bankstatementparser-mcp

---

Quick start

Register the server with any MCP client (Claude Desktop shown):

{

"mcpServers": { "bankstatementparser": { "command": "bankstatementparser-mcp" } } }

That's it. Restart the client and the tools are available to the agent.

By default the server speaks JSON-RPC over stdin/stdout — it is meant to be launched by an MCP client, not used interactively. For a shared deployment, see Transports.

---

Transports

One command line, three transports:

--host and --port change the bind address (defaults 127.0.0.1 and 8000). The HTTP transports carry no authentication of their own: bind loopback, or put the server behind a gateway you trust before binding a routable address. Every release is verified over streamable HTTP with passmcp in both protocol eras and over SSE with the MCP SDK client; see ADR 0001.

{

"mcpServers": { "bankstatementparser": { "url": "http://127.0.0.1:8000/mcp" } } }

---

Tools

All tools delegate to the bankstatementparser parser core, so they behave identically to the library.

• `list_suppo