NBG Rates
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NBG_RATES_DEBUG | No | Set to `1` to log every upstream request to stderr. Include this log in bug reports. | |
| NBG_RATES_BASE_URL | No | The NBG host to call. Defaults to `https://nbg.gov.ge`; a trailing slash is removed. Useful for testing. | https://nbg.gov.ge |
| NBG_RATES_HTTP_HOSTS | No | Host names the HTTP endpoint (`--http`, Lambda) answers for, comma separated. Unset or empty: any host. | |
| NBG_RATES_OPENAI_CHALLENGE | No | The token OpenAI's domain verification expects at `/.well-known/openai-apps-challenge`, served as plain text. Unset or empty: that path is a 404. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| nbg_get_ratesA | 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_convertA | 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_manyA | 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_currenciesA | 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_historyA | 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. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| nbg_rates_today | Today's official NBG rates of the lari for a few currencies |
| nbg_rate_on_date | The official NBG rate of one currency in force on a date |
| nbg_convert_amount | Convert an amount at the official NBG rate in force on a date |
| nbg_monthly_rates | The official NBG rate of one currency for every day of a month, as a table |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Today's NBG rates | Full official NBG rate table in force on a calendar date (YYYY-MM-DD) or "today", as JSON with per-unit rates. |
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose: single-date multi-currency rates (nbg_get_rates) vs single-currency date range (nbg_rate_history) vs single conversion (nbg_convert) vs batch conversion (nbg_convert_many) vs currency listing (nbg_list_currencies). The single/batch and single-date/range distinctions are spelled out in the descriptions, leaving little room for misselection.
All names share a consistent nbg_ prefix and snake_case, and four of five are verb-first (get_rates, convert, convert_many, list_currencies). nbg_rate_history breaks the verb-first convention by leading with a noun, a minor deviation from an otherwise predictable pattern.
Five tools is well-scoped for an exchange-rate service, covering current rates, historical ranges, single conversion, batch conversion, and currency enumeration. Each tool earns its place with no redundant or filler operations.
The surface covers the full lifecycle of the domain: discovering available currencies, fetching rates for a date or a range, and converting both single and batch amounts. No obvious gaps or dead ends for rate lookup and conversion workflows.