# cnb

cnb gives coding agents access to official Czech National Bank exchange rates for CZK and other currencies. Use it to check past rates or convert an amount for an accounting entry.

- 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/cnb
- Updated: 2026-10-15
- HTML: https://affpapa.org/en/nevibecode/mcp/cnb

## What it does

cnb connects an AI agent to daily and historical exchange-rate data published by the Czech National Bank (ČNB). The rates cover CZK against EUR, USD and other currencies. Historical lookups accept a valid ISO date, which helps when checking the rate associated with an earlier invoice.

The server exposes three tools. `get_rates` retrieves the complete daily rate sheet, while `get_rate` returns a single currency's rate against CZK. Use `convert` to calculate an amount between ISO 4217 currencies using ČNB rates. A USD-to-EUR conversion belongs in `convert`, not `get_rate`.

You can connect through the hosted MCP endpoint or run the package locally with `npx` and `@czagents/cnb`. The central bank's rate sheet is free to access, but the hosted endpoint applies per-IP request limits. Running the project from source requires Node.js and the listed build commands; the local setup avoids the hosted endpoint's IP-based limit.

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

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

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

## When to use it
- Retrieve the latest daily ČNB exchange-rate sheet
- Look up the EUR-to-CZK rate for a past date
- Convert a USD amount into CZK using official rates
- Check a currency rate for an accounting record

## Example prompts
- Find the official ČNB EUR-to-CZK rate for `2024-01-15`.
- Convert 100 USD to CZK using ČNB rates for `2024-01-15`.
- Retrieve the complete daily ČNB rate sheet for `2024-01-15`.

## 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