mcp-cbr-rates MCP server

<!-- mcp-name: io.github.atomno-mcp/mcp-cbr-rates -->

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

getrate, historyrates, key_rate, inflation, statistics.

• Five high-quality MCP tools, each with a strict Pydantic schema:

historical series, to be polite to the source.

• Built-in TTL (Time-To-Live) cache: 1 hour for daily quotes, 24 hours for

• 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)

pipx install atomno-mcp-cbr-rates
atomno-mcp-cbr-rates  # starts the MCP server over stdio

Or with uv:

uv tool install atomno-mcp-cbr-rates

Install from source

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

Use with Cursor

Add the following to .cursor/mcp.json (or your global ~/.cursor/mcp.json):

{
  "mcpServers": {
    "cbr-rates": {
      "command": "atomno-mcp-cbr-rates"
    }
  }
}

Use with Claude Desktop

Add to claudedesktopconfig.json:

{
  "mcpServers": {
    "cbr-rates": {
      "command": "atomno-mcp-cbr-rates"
    }
  }
}

On Windows the config lives at %APPDATA%\Claude\claudedesktopconfig.json; on macOS at ~/Library/Application Support/Claude/claudedesktopconfig.json.

Use with Claude Code

claude mcp add cbr-rates -- atomno-mcp-cbr-rates

Tools

Examples in plain English:

"What was the official EUR rate on April 25, 2024?"

Tool: getrate(charcode="EUR", on_date="2024-04-25")

"Plot the daily USD-RUB rate over the last 90 days."

Tool: historyrates(charcode="USD", datefrom=..., dateto=...)

"Give me the latest key rate, USD/EUR/CNY, and inflation in one go."

Tool: statistics()

Shortened. The full README is on GitHub.