atomno-mcp/mcp-cbr-rates

> A Model Context Protocol (MCP) server that exposes public Bank of Russia
> (Центральный банк РФ, **CBR**) data — currency quotes, key rate, inflation
> and a compact macro snapshot — to AI agents.
mcp-cbr-rates is part of the atomno family of MCP
servers focused on the Russian fintech ecosystem. It is fully open-source,
requires no API keys, and is built on top of the official public CBR
endpoints.
---
Features
- Five high-quality MCP tools, each with a strict Pydantic schema:
get_rate, history_rates, key_rate, inflation, statistics.
- Built-in TTL (Time-To-Live) cache: 1 hour for daily quotes, 24 hours for
historical series, to be polite to the source.
- Async httpx transport with automatic retries on 5xx errors.
- Safe XML parsing via defusedxml.
- 50+ unit tests with respx-mocked HTTP, ≥80 % coverage.
- No secrets, no telemetry, no third-party trackers.
---
Quick start
Install from PyPI (recommended)
Or with uv:
Install from source
Use with Cursor
Add the following to .cursor/mcp.json (or your global ~/.cursor/mcp.json):
Use with Claude Desktop
Add to claude_desktop_config.json:
On Windows the config lives at
%APPDATA%\Claude\claude_desktop_config.json; on macOS at
~/Library/Application Support/Claude/claude_desktop_config.json.
Use with Claude Code
---
Tools
| Name | Inputs | Returns |
|---|---|---|
| get_rate | char_code: str, on_date?: date | CurrencyRate — single quote on the given (or latest) date |
| history_rates | char_code: str, date_from: date, date_to: date | HistoryRates — series of daily quotes |
| key_rate | date_from?: date, date_to?: date | KeyRateHistory — CBR key-rate series |
| inflation | year_from?: int, year_to?: int | InflationData — monthly year-over-year CPI in percent |
| statistics | _(none)_ | MacroSnapshot — combined dashboard: key rate + USD/EUR/CNY + inflation |
Examples in plain English:
> *"What was the official EUR rate on April 25, 2024?"*
> Tool: get_rate(char_code="EUR", on_date="2024-04-25")
> *"Plot the daily USD-RUB rate over the last 90 days."*
> Tool: history_rates(char_code="USD", date_from=..., date_to=...)
> *"Give me the latest key rate, USD/EUR/CNY, and inflation in one go."*
> Tool: statistics()
The history_rates window is capped at 366 days; for longer periods, call
the tool repeatedly.
---
Configuration
All settings are optional and read from environment variables:
| Variable | Default | Description |
|---|---|---|
| MCP_CBR_HTTP_TIMEOUT | 15 | HTTP timeout in seconds for CBR calls. |
| MCP_CBR_CACHE_DAILY_TTL | 3600 | Cache TTL for daily quotes (seconds). |
| MCP_CBR_CACHE_HISTORY_TTL | 86400 | Cache TTL for historical series and SOAP responses. |
| MCP_CBR_LOG_LEVEL | INFO | Standard Python log level. |
Legacy CBR_* names are still accepted for compatibility, but new configs should use MCP_CBR_*.
There are no API keys to configure — all CBR endpoints used here are public.