mcpField
C
cbar

cbar

Local
github.com/azerbaijan-mcpFinance1Updated 3d ago
Repository

About cbar

cbar is an MCP server for clients that need official Azerbaijan Central Bank reference rates. It reads CBAR’s public XML feed and supports rate lookup and AZN-based conversion.

Key features

  1. 01Look up rates for 38 currencies
  2. 02Get rates for four precious metals
  3. 03Filter rates by currency code
  4. 04Convert currencies through AZN
  5. 05Identify the rate sheet date used

Use cases

  1. 01Check official USD or EUR reference rates
  2. 02Convert an amount between supported currencies
  3. 03Retrieve historical rates for a specified date

MCP support

It exposes `get_rates` and `convert` tools to MCP clients. The server reads CBAR’s public XML feed.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "azerbaijan-mcp-cbar": {
      "command": "uvx",
      "args": [
        "azerbaijan-mcp-cbar"
      ]
    }
  }
}
Run commanduvx azerbaijan-mcp-cbar

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypiazerbaijan-mcp-cbar0.1.0

Tools

2

Saved tool list · updated 5d ago

ParameterTypeRequiredDescription
dateanyNoYYYY-MM-DD. Defaults to today (Baku time).
codesanyNoOnly these codes, for example ["USD", "EUR"]. Default: all.

Details

From the project README

azerbaijan-mcp-cbar

MCP server for the official exchange rates of the Central Bank of the Republic of Azerbaijan (CBAR). It reads CBAR's public XML feed (https://cbar.az/currencies/DD.MM.YYYY.xml): no API key, no scraping.

Tools

ToolWhat it does
get_rates(date?, codes?)Official AZN rates for 38 currencies and 4 precious metals. date is YYYY-MM-DD (default: today, Baku time). codes filters, for example ["USD", "EUR"].
convert(amount, from_currency, to_currency, date?)Converts through AZN with the official rates. AZN is accepted as a code.

Things worth knowing:

  • Rates are AZN per nominal units. Seven currencies are quoted per 100 (JPY, KRW, KZT, HUF, UZS, PKR, RUB). per_unit is already divided.
  • Metals are AZN per troy ounce.
  • CBAR publishes no new sheet on weekends and public holidays. The response says which sheet it used (sheet_date, note).
  • These are official reference rates, not bank buy/sell rates.

Install

Add to your MCP client configuration (requires uv):

{
  "mcpServers": {
    "cbar": {
      "command": "uvx",
      "args": ["azerbaijan-mcp-cbar"]
    }
  }
}

In Claude Code: claude mcp add cbar -- uvx azerbaijan-mcp-cbar.

Data source and terms

The data is published by CBAR at https://cbar.az/currency/rates, which invites importing the XML URL into applications. The page states no licence or reuse conditions, so this server relies on that implied permission, caches responses (past dates forever, today for 10 minutes) and sends an honest User-Agent. Every response carries an attribution field. Unofficial project, not affiliated with or endorsed by CBAR.

tests/fixtures/rates-2026-10-30.xml is a snapshot of the public feed for 2026-10-30.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.