# NBG Rates (National Bank of Georgia) [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/akalongman/nbg-rates-mcp  
**GitHub Stars:** 3  
**npm Downloads (last month):** 723  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/nbg-rates-national-bank-of-georgia

## Description
GEL exchange rates from the National Bank of Georgia with per-unit values. Not affiliated with NBG.

## Tools
Capabilities this server exposes over MCP:

- **nbg_get_rates** — Official National Bank of Georgia (NBG) exchange rates of the Georgian lari (GEL) in force on one calendar date. Every rate is GEL per ONE unit of the currency (NBG quotes some currencies per 10, 100, 1000 or 10000 units; the raw pair is returned as nbgQuantity and nbgRate). Dates are calendar days in Tbilisi; the default is today. NBG sets a rate on business days around 17:00 Tbilisi time, valid from the next calendar day until the next rate, so after 17:00 tomorrow can be requested by date. Sundays, Mondays and days after a public holiday have no rate of their own: the rate in force was set earlier and is returned with carriedOver true and effectiveDate set to the day it took effect. Quote effectiveDate when carriedOver is true. A date whose rate NBG has not published yet returns an error, never a guess. When nbgQuantity is not 1, state NBG's quoted form first, nbgRate GEL per nbgQuantity units (for example 1.6452 GEL per 100 JPY), and the per-unit rate beside it: that quoted form is what nbg.gov.ge and accounting software show.
- **nbg_convert** — Converts an amount between two currencies using the official NBG rate in force on a calendar date. Either side may be GEL; a pair without GEL is converted through GEL (via: "GEL"). Show resultRounded as the amount; result is the unrounded value for further calculation. Dates are calendar days in Tbilisi; the default is today. NBG sets a rate on business days around 17:00 Tbilisi time, valid from the next calendar day until the next rate, so after 17:00 tomorrow can be requested by date. Sundays, Mondays and days after a public holiday have no rate of their own: the rate in force was set earlier and is returned with carriedOver true and effectiveDate set to the day it took effect. Quote effectiveDate when carriedOver is true. A date whose rate NBG has not published yet returns an error, never a guess.
- **nbg_convert_many** — Converts a list of amounts, each at the official NBG rate in force on its own date: one call for a list of invoices. Items are answered independently; a bad date or code fails only its item, with the error text in that item. total is present when every converted item has the same target currency and covers the converted items only; call it partial when skipped is not 0. Once NBG stops answering, the remaining dates fail with the same error without being asked. Show resultRounded as the amount; result is the unrounded value for further calculation. Dates are calendar days in Tbilisi; the default is today. NBG sets a rate on business days around 17:00 Tbilisi time, valid from the next calendar day until the next rate, so after 17:00 tomorrow can be requested by date. Sundays, Mondays and days after a public holiday have no rate of their own: the rate in force was set earlier and is returned with carriedOver true and effectiveDate set to the day it took effect. Quote effectiveDate when carriedOver is true. A date whose rate NBG has not published yet returns an error, never a guess.
- **nbg_list_currencies** — Lists every currency NBG publishes a GEL rate for today, with its name and the unit quantity NBG quotes it in. NBG quoted other currencies in the past, so a code missing here may still have historical rates. nbgQuantity is the unit count NBG quotes the raw rate for (JPY is quoted as 1.6452 GEL per 100 JPY); for the rates themselves call nbg_get_rates.
- **nbg_rate_history** — Official NBG rate of one currency (GEL per one unit) in force on every calendar day of an inclusive range of at most 366 days. Dates are calendar days in Tbilisi. Days without a rate of their own (Sundays, Mondays and days after a public holiday; before September 2021 NBG set a rate for every calendar day) carry the earlier rate. Days whose own rate is in force contain only date and rate; a carried-over day adds effectiveDate and carriedOver: true. Quote effectiveDate when carriedOver is true. A range reaching a date NBG has not published yet returns an error. summary holds the first, last, change, lowest and highest rate with their dates, and the average over the calendar days, computed by the server: report those rather than deriving them. One NBG request per call.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "nbg-rates-national-bank-of-georgia": {
    "command": "npx",
    "args": ["-y","nbg-rates-mcp"]
  }
}
```

## Documentation

## What NBG Rates (National Bank of Georgia) does

NBG Rates exposes the National Bank of Georgia’s official GEL exchange-rate data to MCP clients. It can retrieve rates for a date, convert amounts using the rate in force on that date, process multiple dated conversions, list currencies currently published by NBG, and return a currency’s daily history for a range of up to 366 calendar days.

Rates are normalized to GEL per one unit of currency. Because NBG sometimes publishes a quote for 10, 100, 1,000, or 10,000 units, responses retain both the original quantity and rate. This lets an application show the quote in NBG’s published form while also using a per-unit value.

The service is independent and is not affiliated with the National Bank of Georgia. NBG’s website remains the source of truth.

## How it works

Dates use the Tbilisi calendar and are written as `YYYY-MM-DD`. If no date is supplied, tools use the current date in Tbilisi. NBG generally sets rates on business days around 17:00 Tbilisi time, with those rates taking effect on the following calendar day.

Sundays, Mondays, and days following public holidays can carry forward the last rate set by NBG. Such results identify the earlier effective date with `carriedOver` and `effectiveDate`. A requested date that NBG has not published produces an error rather than a stale or estimated result.

Conversions can involve GEL on either side. Currency pairs without GEL are routed through GEL. Rounded conversion output uses half-up rounding to two decimal places, while the unrounded result remains available for further calculations. Historical results include daily values and a server-computed summary containing the first, last, change, minimum, maximum, and average.

## Setup and configuration

Claude Desktop users can install the latest `.mcpb` release package, which supplies its own Node.js runtime. Manual configurations use `npx -y nbg-rates-mcp` and require Node.js 22 or later. Claude Code can add the same command with `claude mcp add`, and Cursor can use the corresponding `mcpServers` entry in its MCP settings.

A hosted endpoint is available at `https://nbg-rates.env.ge/mcp` for custom connectors. The service requires no account or API key. The server also supports Streamable HTTP, for example `nbg-rates-mcp --http --port 3000`; `--host 0.0.0.0` makes it listen on every interface. Deployments can use AWS Lambda with API Gateway, and `NBG_RATES_HTTP_HOSTS` restricts responses to the configured public hostname. `NBG_RATES_MIRROR_TABLE` can name a DynamoDB table used as a scheduled NBG data mirror.

## Tools and capabilities

- `nbg_get_rates` returns all currencies or selected ISO 4217 codes for one date, with English or Georgian currency names.
- `nbg_convert` converts one amount at the official rate for a selected date.
- `nbg_convert_many` handles a list of independently dated conversions and can provide a total when all successful items share a target currency.
- `nbg_list_currencies` lists currencies published for today and their NBG quote quantities.
- `nbg_rate_history` returns one currency’s daily rate across an inclusive range of no more than 366 days.

Every tool is read-only and returns structured content along with the same data in a text block.

## Limitations and notes

Historical dates before September 2021 follow different publication behavior because NBG set rates for every calendar day before then. A historical range that reaches an unpublished date fails, and batch conversion items report errors independently. If NBG stops responding during a batch request, remaining items receive the same error without additional requests.

The server reads undocumented NBG endpoints, which may change. The hosted service retains copies of NBG tables for requested past dates and keeps operational and access logs for 30 days; it does not record the amounts or currencies requested.

_Full upstream README: https://allmcps.com/mcp/nbg-rates-national-bank-of-georgia/readme_

