Cnb

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.

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:

{
  "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 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.