# ISO 20022 pain.002 Bank Rejection & Status XML Decoder

> ISO 20022 pain.002 Bank Rejection & Status XML Decoder is a paid MCP server for finance and payments. Decode ISO 20022 pain.002 bank status XML into plain-English rejection reasons. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API
- **Website:** https://geornaden.github.io/finops-studio/iso20022-pain002-decoder.html
- **Repository:** https://github.com/geornaden/finops-studio
- **MCP Registry name:** io.github.Geornaden/iso20022-pain002-rejection-decoder-mcp
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-14

## About

Feed it a raw pain.002 status file, in versions pain.002.001.03 or .10, and it returns JSON or CSV explaining each payment status and what to fix. The decoder covers over 40 codes, among them AC01 (bad IBAN), AC04 (closed account), AM04 (insufficient funds), BE01 (payee name mismatch), BE04 (missing structured address), and MD01 and MD06 for SEPA mandates.

Setting onlyRejectedOrExceptions to true drops accepted items and keeps only RJCT, PART, ACWC and CANC results, which suits alert feeds to Slack, Jira or an ERP. Its input comes from EBICS or SFTP gateway logs.

It belongs to the FinOps Studio suite of deterministic engines and is served through an Apify MCP endpoint.

## Features

- **Code explanations:** Explains over 40 status and rejection codes.
- **Fix guidance:** Adds instructions on how to correct each failure.
- **Exceptions only:** Optionally returns only rejected or partial items.
- **JSON and CSV output:** Machine-readable results for alerts and ERP.
- **Two schema versions:** Handles pain.002.001.03 and .10.

## Good for

- Alert finance on failed SEPA payments
- Explain a bank rejection to a non-specialist
- Feed rejections into Jira tickets
- Triage EBICS gateway logs automatically

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http iso20022-pain002-rejection-decoder-mcp 'https://mcp.apify.com/?actors=finops_studio/iso20022-pain002-status-parser'
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.apify.com/?actors=finops_studio/iso20022-pain002-status-parser
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "iso20022-pain002-rejection-decoder-mcp": {
      "url": "https://mcp.apify.com/?actors=finops_studio/iso20022-pain002-status-parser"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "iso20022-pain002-rejection-decoder-mcp": {
      "type": "http",
      "url": "https://mcp.apify.com/?actors=finops_studio/iso20022-pain002-status-parser"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "iso20022-pain002-rejection-decoder-mcp": {
      "serverUrl": "https://mcp.apify.com/?actors=finops_studio/iso20022-pain002-status-parser"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://mcp.apify.com/?actors=finops_studio/iso20022-pain002-status-parser
```

Enter a Name (for example "ISO 20022 pain.002 Bank Rejection & Status XML Decoder"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "iso20022-pain002-rejection-decoder-mcp": {
      "type": "http",
      "url": "https://mcp.apify.com/?actors=finops_studio/iso20022-pain002-status-parser"
    }
  }
}
```

## FAQ

### Which codes are explained?

Over 40, including AC01, AC04, AM04, BE01, BE04, MD01, MD06 and RR04.

### Can I get only failures?

Yes, with onlyRejectedOrExceptions set to true.

### Which formats come back?

JSON and CSV.

### Is ISO 20022 pain.002 Bank Rejection & Status XML Decoder free?

No. ISO 20022 pain.002 Bank Rejection & Status XML Decoder is a paid product.

### How do I add ISO 20022 pain.002 Bank Rejection & Status XML Decoder to Claude Code?

Run this command in your terminal: claude mcp add --transport http iso20022-pain002-rejection-decoder-mcp 'https://mcp.apify.com/?actors=finops_studio/iso20022-pain002-status-parser'

### What are the best alternatives to ISO 20022 pain.002 Bank Rejection & Status XML Decoder?

The closest alternatives to ISO 20022 pain.002 Bank Rejection & Status XML Decoder are SepaCheck Validator, SEPA XML Generator (pain.001 & pain.008) & IBAN Validator, FinOps Studio — Banking, Payroll & E-Invoicing, ISO 20022 Navigator and Corporate BAI2 Bank Statement Parser to JSON & CSV.

## Where this comes from

- Description: written from the project's README and the project's website.
- Status: checked automatically by AIPoweredBot on 18 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [SepaCheck Validator](https://ai-powered.com/mcp/sepacheck-validator): SepaCheck Validator is a freemium MCP server for finance and payments.
- [SEPA XML Generator (pain.001 & pain.008) & IBAN Validator](https://ai-powered.com/mcp/sepa-xml-generator-pain-001-and-pain-008-and-iban-validator): SEPA XML Generator (pain.001 & pain.008) & IBAN Validator is a paid MCP server for finance and payments.
- [FinOps Studio — Banking, Payroll & E-Invoicing](https://ai-powered.com/mcp/finops-studio-banking-payroll-and-e-invoicing): FinOps Studio — Banking, Payroll & E-Invoicing is a paid MCP server for finance and payments.
- [ISO 20022 Navigator](https://ai-powered.com/mcp/iso-20022-navigator): ISO 20022 Navigator is a free MCP server for finance and payments.
- [Corporate BAI2 Bank Statement Parser to JSON & CSV](https://ai-powered.com/mcp/corporate-bai2-bank-statement-parser-to-json-and-csv): Corporate BAI2 Bank Statement Parser to JSON & CSV is a paid MCP server for finance and payments.
- [IoMarkets.tech ISO 20022 Test Bench](https://ai-powered.com/mcp/iomarkets-tech-iso-20022-test-bench): IoMarkets.tech ISO 20022 Test Bench is an MCP server for finance and payments.
- [FinOps Studio Zero-Auth Bank Validator & 2-Row Taste-Test MCP](https://ai-powered.com/mcp/finops-studio-zero-auth-bank-validator-and-2-row-taste-test): FinOps Studio Zero-Auth Bank Validator & 2-Row Taste-Test MCP is a freemium MCP server for finance and payments.
- [InvoiceIn](https://ai-powered.com/mcp/invoicein): InvoiceIn is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/iso-20022-pain-002-bank-rejection-and-status-xml-decoder
