# payqr

Generates European payment QR codes for SPAYD and SEPA EPC, decodes receipt images, and builds standard codes for Wi-Fi or contacts locally.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Author: martinhavel
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/martinhavel/cz-agents-mcp/tree/HEAD/packages/payqr
- Updated: 2026-10-15
- HTML: https://affpapa.org/en/nevibecode/mcp/payqr

## What it does

The server creates scannable payment codes accepted by banking applications in the Czech Republic, Slovakia, and across the Eurozone. It inspects the IBAN country prefix automatically, choosing the SPAYD format for Czech or Slovak accounts and EPC GiroCode for other SEPA transfers. In addition, it extracts structured fields from base64 image data.

All calculations run directly on your machine. The server avoids external API dependencies and AI models. Transfers under the EPC standard require a recipient name, which causes validation to fail if omitted. Generating batch runs with up to 50 codes needs an optional x402 payment setup.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://payqr.cz-agents.dev/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http payqr https://payqr.cz-agents.dev/mcp
```

2. **Platform CLI**
```bash
claude mcp add payqr -- npx -y @czagents/payqr
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add payqr --url https://payqr.cz-agents.dev/mcp
```

2. **Platform CLI**
```bash
codex mcp add payqr -- npx -y @czagents/payqr
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "payqr": {
            "url": "https://payqr.cz-agents.dev/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "payqr": {
            "command": "npx",
            "args": [
                "-y",
                "@czagents/payqr"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "payqr": {
            "type": "http",
            "url": "https://payqr.cz-agents.dev/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "payqr": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@czagents/payqr"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http payqr https://payqr.cz-agents.dev/mcp
```

2. **Platform CLI**
```bash
gemini mcp add payqr npx -y @czagents/payqr
```

## When to use it
- generate SPAYD payment QR codes for Czech and Slovak bank accounts
- create SEPA EPC GiroCode QR tags for euro transfers
- extract structured payment details from uploaded receipt images
- produce Wi-Fi network or vCard 3.0 contact QR codes

## Example prompts
- Generate a payment QR code for 1500 CZK to IBAN CZ6508000000192000145399 with variable symbol 1234567890
- Decode the payment details from this QR code screenshot
- Create a Wi-Fi QR code for network Office-Guest with password secret123

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44591
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5469
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2817
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2197
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

From the same set: [martinhavel/cz-agents-mcp](https://affpapa.org/en/nevibecode/by/martinhavel/cz-agents-mcp.md) — 9 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md