mcpField
C
cnb

cnb

Remote
cz-agents.devFinance6Updated 2w ago
RepositoryVisit website

About cnb

cnb is an MCP server for official Czech National Bank exchange rates, with daily and historical CZK rates and conversion. It is intended for accounting and invoicing that require ČNB figures.

Key features

  1. 01Retrieve the full daily rate sheet
  2. 02Look up one currency rate
  3. 03Convert amounts using official rates
  4. 04Query historical rates by date

Use cases

  1. 01Use official rates for accounting
  2. 02Convert invoice amounts on a historical date

MCP support

Exposes ČNB rate lookup and currency conversion tools to MCP clients, including daily sheets and historical-date queries.

Configuration

Remote servers need no local install. Pick your client, then copy the config or install in one click.

Endpointhttps://cnb.cz-agents.dev/mcp
Copy install command
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.

Packages
npm@czagents/cnb0.1.5

Tools

3
ParameterTypeRequiredDescription
datestringNoOptional ISO date (YYYY-MM-DD) for historical rates. Omit for latest.

Details

From the project README

@czagents/cnb

Official Czech National Bank (ČNB) exchange rates — daily and historical CZK rates against EUR, USD, and 30+ currencies. Direct from the central bank, the authoritative source for accounting and invoicing in the Czech Republic.

Install

npm install -g @czagents/cnb

Usage with Claude Desktop

{
  "mcpServers": {
    "cnb": {
      "command": "npx",
      "args": ["-y", "@czagents/cnb"]
    }
  }
}

Tools

get_rates

Use it to obtain the full ČNB daily currency sheet, either latest or for a valid historical ISO date. Do not use it when only one currency rate is needed; use get_rate.

{"date":"2024-01-15"}
convert

Use it to convert a numeric amount between ISO 4217 currencies with ČNB’s official daily rates, including a historical date when necessary. Do not use it for a rate quotation without an amount; use get_rate.

{"amount":100,"from":"USD","to":"CZK","date":"2024-01-15"}
get_rate

Use it to retrieve one currency’s official CZK rate from the latest or a historical ČNB sheet. Do not use it for a cross-currency conversion such as USD to EUR; use convert.

{"code":"EUR","date":"2024-01-15"}

Self-host

Source: https://github.com/martinhavel/cz-agents-mcp

git clone https://github.com/martinhavel/cz-agents-mcp
cd cz-agents-mcp
npm install
npm run build
node packages/cnb/dist/index.js

Free tier & pricing

ČNB exposes the rate sheet for free. The hosted endpoint at https://cnb.cz-agents.dev/mcp is rate-limited per IP. Higher limits and commercial use: https://cz-agents.dev/pricing.html

License

MIT — see LICENSE

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.