Repository avatar
AI Tools
v0.0.90
active

pain001-mcp

io.github.sebastienrousseau/pain001-mcp

ISO 20022 payment files for agents: generate, validate, and convert pain.001, pain.008, MT101.

Documentation

pain001-mcp logo

pain001-mcp

Expose pain001 validation, generation and inspection as MCP tools.

Build Registry Docs OpenSSF Scorecard License: Apache-2.0 OR MIT Python 3.11 or newer

pain001-mcp --help, then examples/01_mcp_tools.py listing the registered tools, validating an IBAN and generating pain.001 XML


Contents

Getting started

The pain001-mcp ecosystem

Library reference

Operational


Install

As a Python library

python -m pip install pain001-mcp

Latest release: v0.0.90: released with pain001 0.0.90. Requires pain001 0.0.90 and pain001-loader-mt101 0.0.90; the 30 MCP tools behave as they did in 0.0.89.

Test unreleased changes on this companion's feat/v<next-version> branch against the matching core branch.


Requirements

Python 3.11 or newer. CI tests 3.11–3.14 on Linux. See toolchain policy; no distro-system-Python claim is made.


Quick Start

pain001-mcp --help
pain001-mcp

The second command starts the stdio MCP server and waits for a client. Configure your client to launch pain001-mcp. Use generated help for optional HTTP/SSE transports; secure network access before exposing any listener.


The pain001-mcp ecosystem

This independently installed companion delegates payment behavior to core. Coordinated versioning does not imply branch changes have been released.

ComponentPurposeUse case
pain001Generation and validationShared contracts and XML engine

Capabilities at a glance

AreaCapabilityStatus
IntegrationPayment validation and generation toolsReleased; branch work is test-gated until it ships

Ecosystem comparison

This matrix describes the repository's scope, not an independently benchmarked comparison with competitors.

ProjectGenerate payment XMLReal settlementSynthetic bank replies
pain001-mcpDelegates to coreNoNot a bank service

See docs/COMPARISON.md for the evidence and complete matrix.


Benchmarks

CI smoke-runs benchmarks. No hardware-independent throughput or latency promise is made; use the generated run report for measurements.

ScenarioResultEnvironment
Adapter operationsRun-specificPython, hardware and dependency versions recorded per run

See docs/BENCHMARKS.md for methodology and full results.


Features

The authoritative tool catalogue is generated from the server. It covers validation, identifiers, generation, migration, bank-report parsing, corpus access, review-only record fixes (suggest_record_fix) and the faces (list_faces, project_face). Suggestions require review; financial fields are refused, never guessed. Test unreleased tools with the matching core feature branch. In-tree core MCP is a separate smaller surface.


Configuration

Run pain001-mcp --help for transport, host and port options. Stdio is default. See the tool catalogue for request shapes rather than a copied tool count.


Examples

Run the self-checking scripts under examples/. Tests cover valid and malformed inputs and integration with the core contract.


When not to use pain001-mcp

Not a bank, settlement engine or autonomous payment approver. Review outputs before use. Transport support is not bank certification.


Development

poetry install
poetry run make check
poetry run make security
poetry run python scripts/tool_catalogue.py --check
poetry run python scripts/render_readme.py --check

Coverage is gated at 100% line and branch. See CONTRIBUTING.md and DEVELOPMENT.md. README is generated from the canonical layout and docs/readme-values.json; CI rejects drift.


Security

Treat requests as untrusted. Protect HTTP listeners and avoid real secrets in logs. Tools may read authorized input paths. Corrections never patch IBANs, BICs, amounts or currencies.

Report vulnerabilities according to SECURITY.md.


Documentation

What is pain.001? · User manual · API reference · Developer guide · Family map


Stability guarantees

Versions advance in coordinated 0.0.1 steps with core. The maintainer opens releases; this iteration ships 0.0.90 with the family. Contract and output changes need compatibility review. No stronger platform or stability guarantee is implied.


License

Dual-licensed under Apache-2.0 OR MIT, at your option. See LICENSE. Dependencies retain their own licences.