sebastienrousseau/pacs008-mcp

![pacs008-mcp banner][banner]
[![PyPI Version][pypi-badge]][07]
[![Python Versions][python-versions-badge]][07]
[![PyPI Downloads][pypi-downloads-badge]][07]
[![Licence][licence-badge]][01]
[![Tests][tests-badge]][tests-url]
[![Quality][quality-badge]][quality-url]
[![Documentation][docs-badge]][docs-url]
[![Glama MCP server score][glama-badge]][glama-url]
**A [Model Context Protocol][mcp] server that exposes the [pacs008][core]
ISO 20022 FI-to-FI Customer Credit Transfer library as tools for AI agents and
assistants** — discover message types and scheme profiles, validate records
against the JSON Schema and against a rail's usage guidelines, generate
validated XML, validate raw XML against the bundled XSD, and parse inbound
messages, all from your favourite MCP client.
> **Latest release: v0.0.14**: 16 MCP tools over stdio, streamable HTTP or
> SSE, all backed by the pacs008 library, for Python 3.10+. Adds convert_mt103, the legacy SWIFT
> MT103 → pacs.008 (MT→MX) migration path.
Contents
- Overview
- Install
- Quick Start
- Transports
- Tools
- November 2026 structured-address cliff
- Using the tools
- Development
- Documentation
- License
- Contribution
- 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. **pacs008-mcp**
is an MCP server that turns the [pacs008][core] library into a set of
first-class agent tools, so an assistant can generate, validate, and parse
**ISO 20022 pacs.008 FI-to-FI Customer Credit Transfer XML messages** — and
the related pacs.002/.004 status and return messages — directly from a
conversation.
Every tool is a thin, typed wrapper over the pacs008 library — the same
package used by the CLI and REST API — so all interfaces behave identically.
Tools return JSON-serialisable data; on a validation error they return an
{"error": ...} payload rather than raising.
- **Website:**
- **Source code:**
- **Bug reports:**
Install
**pacs008-mcp** runs on macOS, Linux, and Windows and requires **Python 3.10+**
and **pip**. It pulls in the core pacs008 library and the MCP SDK
automatically.
> **Note:** while the core pacs008 library is not yet on PyPI, install it from
> source first:
>
>
Quick Start
Launch the server over stdio (the default transport):
Register it with any MCP client (e.g. Claude Desktop) by adding it to the
client's configuration:
Transports
One command line, three transports:
| Command | Transport | Endpoint | Protocol revisions |
| :--- | :--- | :--- | :--- |
| pacs008-mcp | stdio | the client spawns the process | 2026-07-28, 2025-11-25 |
| pacs008-mcp --transport streamable-http | Streamable HTTP | http://127.0.0.1:8000/mcp | 2026-07-28 (stateless, server/discover) and 2025-11-25 (initialize, Mcp-Session-Id) on the same endpoint; responses stream as server-sent events, GET opens the server-to-client stream |
| pacs008-mcp --transport sse | HTTP+SSE (2024-11-05) | http://127.0.0.1:8000/sse and /messages/ | for clients that still expect the older transport |
--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.
Tools
All tools wrap the pacs008 library, so they behave identically to the CLI and
REST API.
- list_message_types — List the 20 supported ISO 20022 pacs message types
- list_schemes — List the registered scheme / usage-guideline profiles
- get_scheme — Inspect a scheme profile's rules