mcp-server-cnb-cache
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CNB_CACHE_URL | No | Base URL of the cnb-cache web interface | http://localhost/cnb-cache/ |
| CNB_CACHE_TIMEOUT | No | Request timeout in seconds | 10 |
| CNB_CACHE_READ_ONLY | No | Accepted for uniformity; all tools are read-only | true |
| CNB_CACHE_TRANSPORT | No | MCP transport | stdio |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Czech National Bank (CNB) daily exchange rates served by a cnb-cache instance. Rates are expressed in CZK per amount units of the foreign currency (e.g. JPY is quoted per 100). CNB publishes no rates on weekends/holidays.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": true
} |
| resources | {
"subscribe": false,
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_rateA | Get the CNB exchange rate (CZK per |
| list_currenciesA | List the currency codes that the cnb-cache instance keeps. |
| convert_amountA | Convert an amount between CZK and a foreign currency (or two foreign currencies via CZK) using CNB rates of a given day. |
| get_rate_historyA | Get daily CNB rates of one currency over a date range (max 31 days). Days without a published rate are skipped. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 4 tools
Each tool has a clearly distinct role: single-day rate lookup (get_rate), currency enumeration (list_currencies), currency conversion (convert_amount), and range history retrieval (get_rate_history). An agent can easily pick the right one based on whether it needs a point lookup, a list, a computation, or a time series.
All four names follow a clean snake_case verb_noun pattern (get_rate, list_currencies, convert_amount, get_rate_history). No mixed conventions or vague verbs.
Four tools is well-scoped for a narrow domain (CNB exchange-rate cache): one per core operation with no redundancy. Nothing feels padded or missing at the tool-count level.
Core lifecycle is covered: rate lookup, currency list, conversion, and historical range. Minor gaps exist, such as fetching the full daily rate sheet for all currencies at once or cache freshness metadata, but agents can work around these with the existing tools.