CBR MCP with caching and a SOAP key rate
mcp-cbr-rates
A Bank of Russia data MCP server with five strictly typed tools, a TTL cache and 52 unit tests on offline fixtures, installed via pipx
- 0 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Installs via pipx and fetches rates, the key rate and inflation from cbr.ru XML and SOAP endpoints
- Needs no keys and caches responses
Install
- Works in
- Services
Manual install
pipx install atomno-mcp-cbr-ratesInstall the package from PyPI.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Installs via pipx and fetches rates, the key rate and inflation from cbr.ru XML and SOAP endpoints
- Needs no keys and caches responses
This is third-party code. Review the repository files before installing.
What it does
The server exposes five tools: a currency rate on a date (get_rate), rate history over a period (history_rates), the key rate over a period (key_rate), monthly year-over-year inflation (inflation), and a combined get_statistics snapshot with the key rate, USD/EUR/CNY rates and inflation in one response. All data is read from public XML and SOAP endpoints on cbr.ru through an async httpx client with automatic retries on 5xx errors and safe XML parsing via defusedxml. A built-in TTL cache holds daily quotes for an hour and historical series for a day, to avoid hammering the source.
Who it is for. For people who want a ready, well-tested source of Bank of Russia rates and the key rate without writing their own parser.
Good fit when
- You need an official rate on a date or rate history over up to 366 days
- You want a single combined macro snapshot in one call (key rate plus main currencies plus inflation)
- It matters that the data source is covered by tests on offline fixtures, not just manual checks
Not a fit when
- You need history over more than 366 days in one call: you will need to split the request
- You need precious metal prices: this server does not provide them, unlike some alternatives
Example request
Plot the USD/RUB rate over the last 90 days and give me the combined macro snapshotMCP
- Transport
- stdio
- Authentication
- not required
Environment variables
MCP_CBR_HTTP_TIMEOUT- HTTP timeout for CBR calls in seconds, defaults to 15
MCP_CBR_CACHE_DAILY_TTL- Cache TTL for daily quotes in seconds, defaults to 3600
MCP_CBR_CACHE_HISTORY_TTL- Cache TTL for historical series in seconds, defaults to 86400
Limitations
The server is unofficial and not affiliated with the Bank of Russia, which the author states explicitly, disclaiming responsibility for data accuracy. The history_rates window is capped at 366 days per call. There are no precious metal prices. If cbr.ru's HTML or XML schemas change, individual tools may break temporarily until the package is updated.
How to disable. Remove the cbr-rates entry from your MCP client config and optionally uninstall the package: pipx uninstall atomno-mcp-cbr-rates.
FAQ
Is it officially affiliated with the Bank of Russia?
No, it is an independent, unofficial wrapper around cbr.ru's open endpoints.
Can I get multi-year history in one call?
No, history_rates is capped at 366 days per call, longer periods need repeated calls.
Discussion
No questions or reviews yet.
Related
All Bank of Russia toolsAn MCP server for official Bank of Russia data: currency rates, rate history, the key rate and precious metal prices, with no auth or keys, installed via npx
Bank of Russia open data MCP server: official exchange rates, rate history, key rate and inflation with no keys
CBR currency exchange MCP server
evo-container-apps-currency-exchange-mcp-server-lab
A Cloud.ru teaching Node.js MCP server: daily Central Bank of Russia exchange rates and conversion to rubles, runs via Docker
Saymon RU Data API: paid Russian data endpoints
Saymon RU Data API
A remote MCP with pay-per-call USDC pricing: INN company checks, Runet search, Russian Post tracking, CBR and MOEX rates
A Claude Code skill that pulls figures from Rosstat, EMISS and the Bank of Russia via local curl and returns a Markdown table with a source link
Devil's Eye: OSINT with a Russian layer
glaz-dyavola
An OSINT tool for passive reconnaissance: EGRUL, FSSP, VK, Telegram and Yandex alongside secret scanning and a 15-tool MCP server
README in short
The README lists the five tools with input and output types, gives pipx or uv install steps, config for Cursor, Claude Desktop and Claude Code, an environment variable table for timeouts and cache TTLs, a list of Bank of Russia data source endpoints, and an explicit unofficial-status disclaimer.