Pacs008 MCP server

pacs008-mcp: An MCP Server for ISO 20022 FI-to-FI Credit Transfers

![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.12 — 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
• Licence
• 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:

flowchart LR
    A["MCP client<br/>(Claude Desktop, IDE, agent)"] -->|stdio| B["pacs008-mcp"]
    B -->|delegates to| C["pacs008 library"]
    C -->|render + validate| D["ISO 20022 pacs XML"]

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.

python -m pip install pacs008-mcp

Note: while the core pacs008 library is not yet on PyPI, install it from

source first:

sh

python -m pip install "git+https://github.com/sebastienrousseau/pacs008.git"

python -m pip install pacs008-mcp

Quick Start

Launch the server over stdio (the default transport):

pacs008-mcp

Register it with any MCP client (e.g. Claude Desktop) by adding it to the client's configuration:

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

Transports

One command line, three transports:

Shortened. The full README is on GitHub.