NBG Rates (National Bank of Georgia) logo

NBG Rates (National Bank of Georgia)

Look up official NBG GEL rates by date and convert currencies using Tbilisi calendar rules and per-unit values.

Install NBG Rates (National Bank of Georgia)

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "nbg-rates-national-bank-of-georgia": {
      "command": "npx",
      "args": [
        "-y",
        "nbg-rates-mcp"
      ],
      "env": {
        "NBG_RATES_HTTP_HOSTS": "YOUR_VALUE_HERE",
        "NBG_RATES_MIRROR_TABLE": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 5 tools correctly (11d ago).

Overview

NBG Rates (National Bank of Georgia) provides official National Bank of Georgia exchange rates for GEL, with date-based lookups and currency conversion over MCP. It normalizes NBG quotations to one unit, identifies rates carried over from earlier calendar days, and rejects dates that NBG has not published. Use it for Georgian accounting, tax, reporting, historical rate checks, and conversions that must follow the NBG rate in force on a specified date. The project is independent of NBG and can run locally or through a hosted MCP endpoint.

Use cases

  • Check the official GEL rate for a historical transaction date
  • Convert foreign-currency amounts using the NBG rate in force
  • Generate a table of daily rates for a month
  • Identify when a weekend or holiday rate was carried over
  • Retrieve selected NBG currencies in English or Georgian

Key features

  • Date-based National Bank of Georgia rate lookups
  • Per-unit GEL normalization
  • Historical and monthly rate queries
  • Currency conversion with two-decimal half-up rounding
  • Tbilisi calendar and carried-over rate handling
  • English and Georgian currency names

Tools5

What NBG Rates (National Bank of Georgia) lets your agent do. Expand a tool for its parameters.

Verified live~1.7k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

7/7 checks healthy over the last 26d

What it can do

From the 5 tools this server returned when we ran it; 5 declare their own safety hints.

Makes network requests · 5Read-only tools · 5
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceSigned build
Package age19 days
Maintainers1

Observed 2026-10-28 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · nbg-rates-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars3Stargazers on the source repository.
npm downloads2.6kPackage downloads in the last 30 days.
Last commit2d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed5Callable tools this server registers over MCP.

How NBG Rates (National Bank of Georgia) works

What NBG Rates (National Bank of Georgia) does

NBG Rates retrieves the official National Bank of Georgia rate in force for a calendar date and provides currency conversions based on that rate. Rates are expressed as GEL for one unit of the selected currency, even when NBG publishes a source quotation for 10, 100, 1,000, or 10,000 units. The original quantity and rate remain available as nbgQuantity and nbgRate.

The server is intended for date-sensitive financial workflows. It can answer current or historical rate questions, return selected currencies or the full available set, and produce monthly rate tables. Currency names can be returned in English or Georgian. It is an independent project, and NBG's website remains the source of truth for the published figures.

How it works

Dates are interpreted as calendar days in Tbilisi and use the YYYY-MM-DD format. NBG generally sets rates on business days around 17:00 Tbilisi time, with those rates applying from the following calendar day. Sundays, Mondays, and days following public holidays may therefore use the most recently set rate. Responses identify this condition with carriedOver and give the date on which the effective rate began.

A request for a date that NBG has not published, including the following day's rate before it becomes available, returns an error rather than a previous or estimated value. Conversion results are calculated from the published figures and rounded half up to two decimal places in resultRounded.

The MCP tools are read-only and return structured content together with the same JSON in a text block. Requests can specify ISO 4217 currency codes, an amount, source and destination currencies, and an optional date. Currency codes are case-insensitive, and GEL can be used as either side of a conversion.

Setup and configuration

For hosted use, add https://nbg-rates.env.ge/mcp as a custom MCP connector in Claude or ChatGPT. The hosted endpoint requires no account or API key. A local Claude Desktop installation can use the downloadable .mcpb release on macOS or Windows, or run npx -y nbg-rates-mcp through its MCP configuration. The npx route requires Node.js 22 or later.

Claude Code can register the server with claude mcp add nbg-rates -- npx -y nbg-rates-mcp. Cursor and other MCP clients can use the same mcpServers entry. The server also supports Streamable HTTP, for example nbg-rates-mcp --http --port 3000, serving /mcp. Self-hosted HTTP deployments can restrict requests with NBG_RATES_HTTP_HOSTS; NBG_RATES_MIRROR_TABLE optionally names a DynamoDB table for mirrored NBG data.

Tools and capabilities

  • Retrieve NBG rates for a requested date or for the current day in Tbilisi.
  • Filter results by one or more ISO 4217 currency codes.
  • Return currency names in English or Georgian.
  • Convert a specified amount between a source currency and a destination currency.
  • Submit batches of one to 100 conversion items.
  • Request historical rates and monthly rate tables.
  • Expose whether a rate was carried over and identify its effective date.

Limitations and notes

The project is not affiliated with the National Bank of Georgia. It reads undocumented NBG endpoints, which may change. Rates for future dates are not guessed when NBG has not published them. The hosted service keeps operational and access logs for 30 days; it does not record the amounts or currencies requested and does not require authentication.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about NBG Rates (National Bank of Georgia)

NBG Rates (National Bank of Georgia) is an MCP server that connects to National Bank of Georgia rate data and exposes read-only tools for retrieving GEL exchange rates and converting amounts. It supports historical dates, Tbilisi calendar rules, per-unit values, selected currencies, Georgian or English names, and explicit carried-over rates.

Install it through the downloadable Claude Desktop extension, an npx MCP configuration, or the hosted endpoint at https://nbg-rates.env.ge/mcp. The npx setup requires Node.js 22 or later; Claude Code and Cursor use the same MCP server configuration with their client-specific locations.

Yes, it works with Cursor by adding the server's mcpServers entry to Cursor's MCP settings. Use ~/.cursor/mcp.json for every project or .cursor/mcp.json for a single project, and configure the local npx command or another supported endpoint.

It returns the last official rate still in force and marks the result with carriedOver when the requested day has no rate of its own. The response also identifies the effective date, which is the day NBG originally set that rate.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewNBG Rates (National Bank of Georgia) AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/nbg-rates-national-bank-of-georgia?style=directory)](https://allmcps.com/mcp/nbg-rates-national-bank-of-georgia)
HTML Embed
<a href="https://allmcps.com/mcp/nbg-rates-national-bank-of-georgia"><img src="https://allmcps.com/api/badge/nbg-rates-national-bank-of-georgia?style=directory" alt="NBG Rates (National Bank of Georgia) on AllMCPs" /></a>