NBG Rates (National Bank of Georgia) MCP server

nbg-rates-mcp

nbg-rates-mcp gives AI agents the official National Bank of Georgia (NBG) exchange rates of the lari (GEL). It runs locally over stdio, needs no account and no key, and encodes the rules a raw call gets wrong: per-unit values, Tbilisi calendar days, an explicit carriedOver flag when a day has no rate of its own, and an error, never a stale rate, for a date NBG has not published yet.

This is an independent open-source project, not affiliated with the National Bank of Georgia. NBG's website, nbg.gov.ge, is the source of truth. The NBG endpoints this server reads are undocumented and may change.

Install

Claude Code

claude mcp add nbg-rates -- npx -y nbg-rates-mcp

To make the server available in every project, add it with user scope:

claude mcp add --scope user nbg-rates -- npx -y nbg-rates-mcp

Claude Desktop

On macOS and Windows, download nbg-rates-mcp-.mcpb from the latest GitHub release and open it. Claude Desktop installs the bundle and runs it with its own Node.js, so nothing else is needed.

On the Claude Desktop Linux beta, elsewhere, or to configure the server by hand, add it to claudedesktopconfig.json:

{ "mcpServers": { "nbg-rates": { "command": "npx", "args": ["-y", "nbg-rates-mcp"] } } }

Cursor and other clients

Add the same mcpServers entry to the client's MCP settings. In Cursor that is ~/.cursor/mcp.json for every project, or .cursor/mcp.json inside one project.

Node.js

npx needs Node.js 22 or later (the Claude Desktop bundle does not). Check with node --version, and install it if needed:

• macOS (Homebrew):

brew install node

• Debian and Ubuntu (NodeSource, Node.js 24):

curl -fsSL https://deb.nodesource.com/setup_24.x -o nodesource_setup.sh
  sudo -E bash nodesource_setup.sh
  sudo apt-get install -y nodejs

• Other Linux distributions (nvm; open a new terminal after the first line):

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.8/install.sh | bash
  nvm install --lts

• Windows (PowerShell):

winget install OpenJS.NodeJS.LTS

• WSL: the same commands as Debian and Ubuntu, run inside the WSL shell.

Tools

Every tool is read-only. Dates are calendar days in Tbilisi in the form YYYY-MM-DD, and every rate is GEL per one unit of the currency. Each tool returns its result as structured content and as the same JSON in a text block.

nbggetrates

The official NBG rates in force on one calendar date. NBG quotes some currencies per 10, 100, 1000 or 10000 units; the rate is always divided down to one unit, and the raw pair is kept as nbgQuantity and nbgRate.

Inputs:

Output:

Shortened. The full README is on GitHub.