@theyahia/cbr-mcp

MCP server for the Central Bank of Russia API — currency rates, key rate, precious metals, conversion. No authorization required, works out of the box.

Part of the Russian API MCP series (50 servers) by @theYahia.

Installation

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "cbr": {
      "command": "npx",
      "args": ["-y", "@theyahia/cbr-mcp"]
    }
  }
}

Claude Code

claude mcp add cbr -- npx -y @theyahia/cbr-mcp

VS Code / Cursor

Add to .vscode/mcp.json:

{
  "servers": {
    "cbr": {
      "command": "npx",
      "args": ["-y", "@theyahia/cbr-mcp"]
    }
  }
}

Windsurf

Add to MCP Toolkit settings:

{
  "mcpServers": {
    "cbr": {
      "command": "npx",
      "args": ["-y", "@theyahia/cbr-mcp"]
    }
  }
}

Authorization is not required — the CBR API is fully open.

Related MCP server: mcp-cbr-rates

Tools (7)

Features

• Weekends and holidays. If rates were not published on the requested date (weekend/holiday), data for the nearest available business day is returned with a note flag.

• Fault tolerance. The primary rate source is the cbr-xml-daily.ru mirror; if it is unavailable, the official cbr.ru (XML_daily.asp) is used as a fallback.

• Data sources: rates — cbr-xml-daily.ru + cbr.ru/scripts/XML_daily.asp; dynamics — cbr.ru/scripts/XML_dynamic.asp; key rate — cbr.ru/hd_base/KeyRate; metals — cbr.ru/scripts/xml_metall.asp.

Example queries

Какой курс доллара сегодня?

Переведи 1000 USD в евро

Как менялся курс доллара с 1 по 23 июня?

Какая ключевая ставка ЦБ и с какого числа она действует?

Покажи историю ключевой ставки за последний год

Какие цены на золото и серебро?

Покажи курсы валют на 10 января 2025

Part of the Russian API MCP series

Development

npm install
npm run build      # компиляция TypeScript → dist/
npm run lint       # eslint
npm test           # vitest (юнит-тесты парсеров на офлайн-фикстурах)
npm run dev        # запуск из исходников через tsx

Tests do not access the network — parsers are tested against saved API responses in test/fixtures/. Changelog is in CHANGELOG.md.

License

MIT