mcp-cbr-rates
About
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.
Details
- Author
- atomno-mcp
- Categories
- Other
Jump to
Setup
Install mcp-cbr-rates in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/atomno-mcp/mcp-cbr-rates
Follow the installation instructions in the repository README, then restart your MCP client.
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-ratesis part of theatomnofamily 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.
- 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.
- Asynchttpxtransport with automatic retries on 5xx errors.
- Safe XML parsing viadefusedxml.
- 50+ unit tests withrespx-mocked HTTP, ≥80 % coverage.
- No secrets, no telemetry, no third-party trackers.
pipx install atomno-mcp-cbr-rates atomno-mcp-cbr-rates # starts the MCP server over stdio
git clone https://github.com/atomno-mcp/mcp-cbr-rates.git cd mcp-cbr-rates pip install -e . atomno-mcp-cbr-rates # starts the MCP server over stdio
Add the following to.cursor/mcp.json(or your global~/.cursor/mcp.json):
{ "mcpServers": { "cbr-rates": { "command": "atomno-mcp-cbr-rates" } } }
{ "mcpServers": { "cbr-rates": { "command": "atomno-mcp-cbr-rates" } } }
On Windows the config lives at%APPDATA%\Claude\claude_desktop_config.json; on macOS at~/Library/Application Support/Claude/claude_desktop_config.json.
claude mcp add cbr-rates -- atomno-mcp-cbr-rates
"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()
Thehistory_rateswindow is capped at 366 days; for longer periods, call the tool repeatedly.
All settings are optional and read from environment variables:
LegacyCBR_names are still accepted for compatibility, but new configs should useMCP_CBR_.
There are no API keys to configure — all CBR endpoints used here are public.
git clone https://github.com/atomno-mcp/mcp-cbr-rates.git cd mcp-cbr-rates python -m venv .venv && source .venv/bin/activate # or .\.venv\Scripts\activate on Windows pip install -e ".[dev]" pytest --cov=src/mcp_cbr_rates
apps/mcp-cbr-rates/ ├── src/mcp_cbr_rates/ │ ├── server.py # FastMCP entry point, tool registration │ ├── tools.py # high-level async tools with caching │ ├── client.py # httpx wrapper around CBR XML / SOAP / HTML endpoints │ ├── schemas.py # Pydantic v2 models for inputs & outputs │ ├── cache.py # async TTL cache │ ├── currency_codes.py # static ISO → CBR id map (with dynamic fallback) │ └── errors.py # typed exception hierarchy └── tests/ # respx-mocked unit tests + fixtures
- https://www.cbr.ru/scripts/XML_daily.asp— daily currency quotes.
- https://www.cbr.ru/scripts/XML_dynamic.asp— historical currency series.
- https://www.cbr.ru/scripts/XML_valFull.asp— currency code lookup.
- https://www.cbr.ru/DailyInfoWebServ/DailyInfo.asmx— SOAP service for the CBR key rate.
- https://www.cbr.ru/hd_base/infl/— monthly year-over-year inflation table.
All endpoints are read-only and free of charge.
This project isnot affiliated with the Bank of Russiain any way. It is an unofficial, best-effort wrapper around publicly available data. Use at your own risk; the authors disclaim any responsibility for the freshness, accuracy or applicability of the data delivered through this server.
If CBR's HTML or XML schemas change, individual tools may stop working until this package is updated. Please open an issue if you notice a regression.
Transaction-complete hotel booking over MCP — 300K+ properties, real hotel confirmation numbers, loyalty points, secure checkout. Hotels are merchant of record. Builders set their own booking fee via Stripe Connect. Built on proven distribution infrastructure.
An MCP server for AI video generation. MCP server for AI video generation. Lets Claude, ChatGPT, OpenClaw , Hermes & other agents create AI videos and publish them to YouTube, TikTok, Instagram etc..
Institutional research and manager diligence reports on hedge funds, venture capital and private equity managers. Summary of filings, personnel changes, media screening and social signals delivered to you in minutes.
ALTER - identity infrastructure for the AI economy
D2C eCommerce fulfillment platform: manage orders, inventory, shipments, campaigns, and billing via AI agents
Apigene MCP Gateway is the runtime layer that connects AI agents to APIs and MCP servers via Model Context Protocol.
MCP to interface with multiple blockchains, staking, DeFi, swap, bridging, wallet management, DCA, Limit Orders, Coin Lookup, Tracking and more.
MCP server for Bitnovo Pay integration with AI agents. Provides cryptocurrency payment capabilities through Bitnovo Pay API. Features include payment creation, status checking, QR code generation, and webhook management with support for multiple tunnel providers (ngrok, zrok, manual).
Shop for gift cards, esims, phone topups. Pay with cards and crypto.
You built it, now get users! GoToMarket MCP server
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.



