# IoMarkets.tech ISO 20022 Test Bench

> IoMarkets.tech ISO 20022 Test Bench is an MCP server for finance and payments. Remote MCP server that validates ISO 20022 payment and securities messages against schema. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Platforms:** API
- **Website:** https://iomarkets.tech/start
- **MCP Registry name:** io.github.SergoVashakmadze/iomarkets-tech
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

The server checks ISO 20022 messages for capital-markets and payments workflows, covering the pacs.008, pain.001, camt.053 and seev.031 message types. Clients connect to it over streamable HTTP at a hosted endpoint, so no local install is needed according to the registry entry.

The site describes it as one of several open test and reference tools for capital-markets plumbing, alongside a tokenized asset map and a free corporate actions feed. The site notes the tools are open source and that the message formats are governed by IoMarkets.org.

It suits developers and operations teams who build or test ISO 20022 integrations and want an AI assistant to check message structure before deployment.

## Features

- **ISO 20022 message validation:** Checks messages of the listed types against their schema and business rules.
- **Remote streamable HTTP endpoint:** Connects to a hosted MCP endpoint without a local package install.
- **Open test tooling:** Part of a set of open source reference tools described on the vendor site.

## Good for

- Validating pain.001 payment initiation files before sending them to a bank
- Checking camt.053 account statements during integration testing
- Verifying seev.031 messages in securities processing test flows
- Giving an AI assistant a schema-check tool for ISO 20022 debugging

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http iomarkets-tech https://iomarkets.tech/mcp
```

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

```sh
https://iomarkets.tech/mcp
```

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

```json
{
  "mcpServers": {
    "iomarkets-tech": {
      "url": "https://iomarkets.tech/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "iomarkets-tech": {
      "type": "http",
      "url": "https://iomarkets.tech/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "iomarkets-tech": {
      "serverUrl": "https://iomarkets.tech/mcp"
    }
  }
}
```

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

```sh
https://iomarkets.tech/mcp
```

Enter a Name (for example "IoMarkets.tech ISO 20022 Test Bench"), 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": {
    "iomarkets-tech": {
      "type": "http",
      "url": "https://iomarkets.tech/mcp"
    }
  }
}
```

## Tools

All 24 tools say they're read-only. From the server's own tool annotations; not verified by us.

- `get_overview` (says read-only): What IoMarkets.tech is and what is built: the ISO 20022 Test Bench, the Data API (market data for AI agents, paid per request over x402), the main pages, and what comes next.
- `get_guide` (says read-only): Step-by-step instructions, with the exact button names, for one task on iomarkets.tech (checking a message, CI, verifying a proof, calling the Data API…). Without a task, lists the tasks.
- `explain_term` (says read-only): A plain-English meaning of a word used on the site (ISO 20022, schema, IBAN, BIC, LEI, ISIN, UETR, CBPR+, x402, signed proof, MCP…) or of an ISO 20022 XML tag abbreviation such as GrpHdr, CdtrAcct or IntrBkSttlmAmt. Without a term, lists the words.
- `list_messages` (says read-only): The ISO 20022 message types and versions the Test Bench checks, with what each is for.
- `validate_message` (says read-only): Check one ISO 20022 XML message (pacs.008.001.08, pacs.009.001.08, pacs.002.001.10, pacs.004.001.09, pain.001.001.09, camt.053.001.08, camt.054.001.08 or seev.031.001.14) against the official base schema, then business rules (check digits, totals, cross-element rules, market practice). Returns valid or not, and every problem with its line, element path, stable code and a plain reason. The message 
- `explain_issue` (says read-only): What a Test Bench issue code (such as IBAN_CHECKSUM, BALANCE_MISMATCH or OUT_OF_ORDER) means and how to fix it. Without a code, lists every code.
- `list_samples` (says read-only): The Test Bench sample library: a valid message of each type and broken ones, each with the issue code it raises. Use get_sample for the XML.
- `reconcile_statement` (says read-only): Match an ISO 20022 bank statement (camt.053.001.08) or notification (camt.054.001.08) against the payments you expected (open invoices, a payment run, a ledger export) and list the exceptions: amount mismatches (short or over payments, charges taken), entries on the statement nobody expected, and expected items not on it. Matches by reference (EndToEndId, InstrId, TxId, AcctSvcrRef, UETR, creditor
- `get_sample` (says read-only): The XML of one sample message from list_samples, to use as a starting point or in tests. Every party and account in it is made up.
- `list_data_endpoints` (says read-only): The Data API routes at https://api.iomarkets.tech, what each returns and its price per call in USDC, with how an AI agent pays (x402 on Algorand mainnet, no account).
- `get_api_status` (says read-only): Whether the Data API at https://api.iomarkets.tech is answering right now, from its /health check.
- `estimate_data_api_cost` (says read-only): What a monthly volume of Data API calls costs at the per-call x402 prices, against the indicative subscription plans. Give calls per month for each route; routes left out count as zero.
- `verify_proof` (says read-only): Check a signed proof (the { payload, signature } JSON a Data API proof route returns): that the ed25519 signature matches the published IoMarkets key, and that its USDC payment is confirmed on Algorand mainnet (looked up on a public indexer IoMarkets does not run).
- `explain_execution_request` (says read-only): Exactly how to call POST https://api.iomarkets.tech/v1/proof/execution, the paid best-execution audit: the body (pair, one of BTC-USDC, ETH-USDC, SOL-USDC, and fills: ts, fill_price, qty, side), the limits (fills per call, how old a fill may be, how close the market trade must be), the price, what comes back, and the answers that are not charged (400 for a bad body or an unsupported pair, 422 when
- `verify_execution_report` (says read-only): Check the whole JSON that POST https://api.iomarkets.tech/v1/proof/execution returned ({ audit, summary, attestation }): that the ed25519 signature matches the published IoMarkets key, that its USDC payment is confirmed on Algorand mainnet (a public indexer IoMarkets does not run), that the rows hash to the signed audit_sha256, and that every row and the summary recompute with the API's own scorin
- `check_token_contract` (says read-only): Check a token contract against the Tokenized Asset Map: is it the issuer's own contract for a tokenized fund or security on that chain? Verdicts: official, other-chain (the address is listed, but on another chain), impostor (a listed symbol on this chain, a different contract), unknown (not in the map, which says nothing either way).
- `list_tokenized_assets` (says read-only): The securities in the Tokenized Asset Map with their identifiers (FIGI, ISIN where the issuer gives it) and the chains they are tokenized on. Optionally filter by issuer, name, symbol, ticker, ISIN or FIGI.
- `get_tokenized_asset` (says read-only): One Asset Map entry in full: the security, every token contract chain by chain, the issuer sources each comes from, and whether its IoMarkets signature verifies. With history, every version of the entry: when the map first showed it, what changed, and the commit behind each.
- `verify_asset_with_issuer` (says read-only): Fetch the issuer's own sources for one Asset Map entry now (its contracts page, its public API, or its stellar.toml) and confirm every listed contract is still there, so trust needn't rest on IoMarkets.
- `list_corporate_actions` (says read-only): Corporate actions of US-listed companies from their own SEC EDGAR filings (8-Ks of US companies, 6-Ks of foreign private issuers): cash dividends (amount in the stated currency, per share or per ADS, ex, record and payment dates), stock splits, reverse splits and completed mergers (cash or shares per share). Filter by holdings (tickers, CIKs or FIGIs), by days (any of an event's dates between from
- `holdings_calendar` (says read-only): For a list of holdings (tickers, CIKs or FIGIs), every ex-date, record date, payment date and effective date in one week, day by day. The week holding `day`, Monday to Sunday; this week by default. Ends with an iCalendar (webcal) subscription URL for those holdings, to give the user for their calendar app.
- `get_corporate_action` (says read-only): One event in full: every date and term, the filing and the sentence or table row it came from, tokenized versions in the Asset Map, and the event as an ISO 20022 seev.031.001.14 notification (checked by the Test Bench). With as_of, the event as the feed showed it at the end of that day; with history, every version: when the feed first showed it, what changed and when, and the filing and code behin
- `token_corporate_actions` (says read-only): For a token contract that the Asset Map lists as a tokenized stock or ETF (such as an xStock): the security it tracks, and that security's dividends, splits and mergers from the corporate actions feed, each with what it does to the token. Answers 'I hold this token; what is coming?' in one call.
- `get_roadmap` (says read-only): What IoMarkets.tech has built and is building next, in the same words as iomarkets.org/roadmap.

## FAQ

### How do I connect to this server?

The registry entry lists a streamable HTTP remote at https://iomarkets.tech/mcp.

### Which message types does it check?

The registry entry names pacs.008, pain.001, camt.053 and seev.031.

### Is it open source?

The vendor site describes the tools as open source, but no licence is named in the content provided.

### How do I add IoMarkets.tech ISO 20022 Test Bench to Claude Code?

Run this command in your terminal: claude mcp add --transport http iomarkets-tech https://iomarkets.tech/mcp

### What are the best alternatives to IoMarkets.tech ISO 20022 Test Bench?

The closest alternatives to IoMarkets.tech ISO 20022 Test Bench are ISO 20022 Navigator, FinOps Studio Zero-Auth Bank Validator & 2-Row Taste-Test MCP, Currency Converter Mcp, Code402 and QuantWorlds.

## Where this comes from

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

## Alternatives

- [ISO 20022 Navigator](https://ai-powered.com/mcp/iso-20022-navigator): ISO 20022 Navigator is a free 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.
- [Currency Converter Mcp](https://ai-powered.com/mcp/currency-converter-mcp): Currency Converter Mcp is a freemium MCP server for finance and payments.
- [Code402](https://ai-powered.com/mcp/code402): Code402 is a freemium MCP server for finance and payments.
- [QuantWorlds](https://ai-powered.com/mcp/quantworlds): QuantWorlds is an MCP server for finance and payments.
- [SepaCheck Validator](https://ai-powered.com/mcp/sepacheck-validator): SepaCheck Validator is a freemium MCP server for finance and payments.
- [IBAN Analyzer](https://ai-powered.com/mcp/iban-analyzer): IBAN Analyzer is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/iomarkets-tech-iso-20022-test-bench
