Payment QR MCP server — SPAYD & EPC/GiroCode for AI agents

The Payment QR MCP server gives an AI agent deterministic tools to generate and read payment QR codes. It automatically uses SPAYD / QR Platba for Czech and Slovak IBANs and EPC / GiroCode for SEPA EUR transfers, validates the IBAN checksum, and returns both the rendered QR image and the exact encoded payload for review.

It also creates standard text, Wi-Fi and vCard QR codes, and can decode a QR image back into structured content. The implementation is open source, has no AI or paid payment API behind it, and the QR generator is available as a free browser tool at qr.cz-agents.dev. Use the hosted MCP endpoint or run it locally with npx.

Install

# Hosted endpoint (Streamable HTTP) payqr.cz-agents.dev/mcp # or run locally npx -y @czagents/payqr

Add it to Claude Desktop or Cursor:

// claude_desktop_config.json "payqr": { "command": "npx", "args": ["-y", "@czagents/payqr"] }

MCP tools

qr_paymentqr_textqr_wifiqr_vcardqr_read

Which payment QR standards does the server support?

It selects SPAYD (QR Platba) for Czech and Slovak IBANs, and EPC / GiroCode for EUR SEPA transfers. The IBAN is validated before a payment code is returned.

Can the MCP server read an existing QR code?

Yes. qr_read decodes a base64 PNG or JPEG QR image and classifies its content. The generator also supports text, Wi-Fi and vCard QR codes.

Is the Payment QR MCP server free?

Yes. @czagents/payqr is MIT-licensed and free to run locally. A hosted Streamable HTTP endpoint is available at payqr.cz-agents.dev/mcp.

Prefer a browser? Generate or read payment QR codes directly in the free browser tool — no signup, all processing stays on your device.

Open QR generator →

npm: @czagents/payqr · GitHub (open source)

Other MCP servers: ares · due-diligence · sanctions · isir · cnb · vat-adis · eu-registry · real-estate