CBR Rates MCP Server

by atomno-labs

710 downloads

Not rated

GitHub

About

MCP server for Central Bank of Russia (CBR) — currency rates (daily/historical), key rate, inflation, and macro statistics. 5 typed tools, built-in TTL cache, no API key required. Part of the atomno family of MCP servers for Russian fintech.

Details

Author: atomno-labs
Downloads: 710
Categories: Other, Finance, API

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name CBR Rates MCP Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "cbr rates mcp server": {
            "cbr-rates": {
                "command": "uvx",
                "args": [
                    "atomno-mcp-cbr-rates"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cbr rates mcp server": {
            "cbr-rates": {
                "command": "uvx",
                "args": [
                    "atomno-mcp-cbr-rates"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cbr rates mcp server": {
            "cbr-rates": {
                "command": "uvx",
                "args": [
                    "atomno-mcp-cbr-rates"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "cbr rates mcp server": {
            "cbr-rates": {
                "command": "uvx",
                "args": [
                    "atomno-mcp-cbr-rates"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cbr rates mcp server": {
            "cbr-rates": {
                "command": "uvx",
                "args": [
                    "atomno-mcp-cbr-rates"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cbr rates mcp server": {
            "cbr-rates": {
                "command": "uvx",
                "args": [
                    "atomno-mcp-cbr-rates"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "cbr rates mcp server": {
            "cbr-rates": {
                "command": "uvx",
                "args": [
                    "atomno-mcp-cbr-rates"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cbr rates mcp server": {
            "cbr-rates": {
                "command": "uvx",
                "args": [
                    "atomno-mcp-cbr-rates"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cbr rates mcp server": {
            "cbr-rates": {
                "command": "uvx",
                "args": [
                    "atomno-mcp-cbr-rates"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "cbr rates mcp server": {
            "cbr-rates": {
                "command": "uvx",
                "args": [
                    "atomno-mcp-cbr-rates"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cbr rates mcp server": {
            "cbr-rates": {
                "command": "uvx",
                "args": [
                    "atomno-mcp-cbr-rates"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cbr rates mcp server": {
            "cbr-rates": {
                "command": "uvx",
                "args": [
                    "atomno-mcp-cbr-rates"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "cbr rates mcp server": {
            "cbr-rates": {
                "command": "uvx",
                "args": [
                    "atomno-mcp-cbr-rates"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cbr rates mcp server": {
            "cbr-rates": {
                "command": "uvx",
                "args": [
                    "atomno-mcp-cbr-rates"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cbr rates mcp server": {
            "cbr-rates": {
                "command": "uvx",
                "args": [
                    "atomno-mcp-cbr-rates"
                ]
            }
        }
    }
}

From the repository

Install the package with pipx install atomno-mcp-cbr-rates or uv tool install atomno-mcp-cbr-rates, then run mcp-cbr-rates. For configuration in Cursor or Claude Desktop, add an MCP server entry with command uvx and argument atomno-mcp-cbr-rates.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "cbr rates mcp server": {
            "cbr-rates": {
                "command": "uvx",
                "args": [
                    "atomno-mcp-cbr-rates"
                ]
            }
        }
    }
}

McpServers

{
    "cbr-rates": {
        "command": "uvx",
        "args": [
            "atomno-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-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.

Connect to any financial, utility, billing accounts; retrieve balance, transactions, payment and identity data instantly.

Analyze and visualize financial data of listed companies using the DART API.

Real-time electricity spot prices and contract recommendations for AI agents — covering the Nordics and Germany.

Stock Market & Financial Data MCP Server – FinancialData.Net

Options Analytics API - GEX Exposure Greeks Volatility

MCP server for Indian APIs — GSTIN, IFSC, PAN, UPI, pincode, HSN/SAC. Zero auth. Offline-first. For AI agents.

Brazilian fixed income & financial data for AI - Selic, CDI, IPCA, CDB/LCI rankings and market quotes via JSON-RPC

Real-time oil, gas, and commodity prices. 40+ energy commodities with natural language queries, price subscriptions, and analyst prompts.

A simple MCP server that grabs prediction market data from polymarket, PredictIt, & Kalshi.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

GitLab

Reactive Resume