# @czagents/cnb [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/martinhavel/cz-agents-mcp  
**GitHub Stars:** 6  
**npm Downloads (last month):** 893  
**Views:** 8  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/-czagents-cnb

## Description
Czech National Bank (ČNB) daily FX rates: fetch official CZK exchange rates, convert between currencies, fetch historical rates. Cached 10 min to ease upstream load. npm @czagents/cnb or HTTP at cnb.cz-agents.dev/mcp.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

## Documentation

## What @czagents/cnb MCP server does

@czagents/cnb MCP server provides access to Czech National Bank exchange-rate data. Its three MCP tools cover the complete daily FX sheet, an individual currency rate, and currency conversion. Rates are expressed around CZK, and conversion uses CZK as the intermediary currency. An optional date parameter allows callers to request historical rates instead of the current daily sheet.

This is a focused choice for Czech or EU workflows that need official ČNB reference data. Typical uses include displaying CZK exchange rates, converting invoice values, and looking up the rate applicable on a previous date. The supplied material describes a 10-minute cache, intended to reduce repeated requests to the upstream service.

## How it works

The server accepts structured MCP tool calls and obtains the corresponding data from the Czech National Bank source. `get_rates` returns the full daily FX sheet. `get_rate` narrows the request to one currency by its code. `convert` takes an amount and two currency codes and calculates a CZK-crossed conversion; it also accepts an optional date.

The date parameter is available on all three tools. Omitting it requests the current available rate data, while supplying it makes a historical lookup or conversion possible. The material does not specify the accepted date format, currency-code format beyond the `code` and `from`/`to` fields, or the exact response schema.

## Setup and configuration

Install the npm package as a local stdio MCP server with `npx`:

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

The package is listed for Claude Desktop and Cursor configurations. No environment variables or credentials are shown for the local setup. A hosted Streamable HTTP deployment is also documented at `https://cnb.cz-agents.dev/mcp`, which can be configured using the client’s URL-based MCP connection settings. The repository identifies the project under the MIT license.

## Tools and capabilities

@czagents/cnb MCP server exposes these tools:

- `get_rates({ date? })` — returns the complete daily FX sheet, or the sheet for the requested date.
- `get_rate({ code, date? })` — retrieves the rate for one currency code, optionally for a historical date.
- `convert({ amount, from, to, date? })` — converts an amount between two currencies through CZK, optionally using historical rates.

The tools are limited to exchange-rate retrieval and conversion. They do not provide company data, sanctions screening, payment execution, or broader financial-market information.

## Limitations and notes

The source material identifies the data as official Czech National Bank daily FX rates, not live intraday quotes. The documented cache duration is 10 minutes, so repeated calls may use cached upstream data during that interval. Conversion is specifically described as CZK-crossed, which matters when selecting this server for applications that require a direct market pair or another conversion methodology.

The repository also advertises hosted services and other MCP packages, but those are separate from the `@czagents/cnb` package. The available information does not state hosted authentication requirements, rate limits, supported currency codes, date-format rules, or guaranteed historical-data coverage.

_Full upstream README: https://allmcps.com/mcp/-czagents-cnb/readme_