Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

NBG Rates (National Bank of Georgia)

by akalongmanversion 0.7.1i★ 3iComputer or cloudOfficial site ↗
Registry nameio.github.akalongman/nbg-rates

How to install

What it does

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

  • Connects Computer or cloud
  • Account or key No key needed
  • Category Accounting, finance & tax

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity7/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering8/8The cloud endpoint answered at the last check
Usage score27/100

Quality: Passed 5/5 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install NBG Rates (National Bank of Georgia). Follow https://mcp.popnx.com/i/akalongman-nbg-rates.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 5/5 checks · What you ask goes through the maker’s server (nbg-rates.env.ge) · ✓ Commands checked Nov 17, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude · about 2 min

No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it

  1. Open Claude’s Connectors page

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Click “Add” → “Custom” → “Web” and fill in these 2 fields

    Copy each value into the field with the same name in Claude, then click Continue

    Name · NameNBG Rates (National Bank of Georgia)
    Remote MCP server URL · Addresshttps://nbg-rates.env.ge/mcp

    Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add

  3. Turn it on in a chat

    +ConnectorsNBG Rates (National Bank of Georgia)

  4. Try it

    Use NBG Rates (National Bank of Georgia) and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using NBG Rates (National Bank of Georgia) or shows a NBG Rates (National Bank of Georgia) tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with ChatGPT, depending on your plan

Full MCP: ChatGPT Business, Enterprise or Edu on the web · Pro: connects with read/fetch permissions, so tools that change data may not work · Plus: not confirmed in OpenAI’s docs; if you see an add-custom-MCP option on the Plugins page you can try these steps · web only

  1. Open ChatGPT’s add-MCP page on the web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Fill in the name and address

    Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin

    Name · NameNBG Rates (National Bank of Georgia)
    Connection · Addresshttps://nbg-rates.env.ge/mcp
  3. Pick NBG Rates (National Bank of Georgia) in a chat

    Start a new chat and pick NBG Rates (National Bank of Georgia) from your plugins before typing

  4. Try it

    Use NBG Rates (National Bank of Georgia) and tell me what you can do for me, then show me one thing

    ✓ If ChatGPT says it is using NBG Rates (National Bank of Georgia) or shows a NBG Rates (National Bank of Georgia) tool in the answer, you are connected

Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Claude Code · about 2 min

No key, nothing to install

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  2. Paste this command and press Enter

    claude mcp add --transport http --scope user nbg-rates https://nbg-rates.env.ge/mcp
  3. Type /mcp in Claude Code

    You should see NBG Rates (National Bank of Georgia) listed as connected

  4. Try it

    Use NBG Rates (National Bank of Georgia) and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using NBG Rates (National Bank of Georgia) or shows a NBG Rates (National Bank of Georgia) tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor · about 2 min

No key, nothing to install

  1. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  2. Open the AI chat in Cursor in Agent mode

  3. Try it

    Use NBG Rates (National Bank of Georgia) and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using NBG Rates (National Bank of Georgia) or shows a NBG Rates (National Bank of Georgia) tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code · about 2 min

No key, nothing to install

  1. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  2. Open the AI chat in VS Code in Agent mode

  3. Try it

    Use NBG Rates (National Bank of Georgia) and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using NBG Rates (National Bank of Georgia) or shows a NBG Rates (National Bank of Georgia) tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://nbg-rates.env.ge/mcp

JSON settings are under “For developers” below

Stuck? Ask people who use NBG Rates (National Bank of Georgia)💬 Discussion →
For developers: Terminal commands and JSON settings

Over the web

Claude Code

claude mcp add --transport http --scope user nbg-rates https://nbg-rates.env.ge/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "nbg-rates": {
      "url": "https://nbg-rates.env.ge/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "nbg-rates": {
      "type": "http",
      "url": "https://nbg-rates.env.ge/mcp"
    }
  }
}

Installed on your computer

Claude Code

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

Claude Desktop (claude_desktop_config.json)

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

Cursor (~/.cursor/mcp.json)

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

VS Code (mcp.json)

{
  "servers": {
    "nbg-rates": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "nbg-rates-mcp"
      ]
    }
  }
}

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
102/wk
Connection
Computer or cloud
Transport
stdio, streamable-http
Latest versioni
0.7.1
Published to registryi
Nov 17, 2026
Code last changedi
Nov 17, 2026
Last checked
Nov 18, 2026
Maker
akalongman
Packages
npm: nbg-rates-mcp
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Tool names and descriptions exactly as the server reported them on Nov 18, 2026. The maker wrote them, not us; we show them as plain text.

  • 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). Date

  • 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

  • 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

  • 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

  • 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 r

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account akalongman, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 2 days ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • ✓ Pass

    Endpoint responds

    Responded in 937 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 5 tool descriptions and found no hidden instructions to the AI

The cloud address answered 4 of the last 4 checks · latest 937 ms · checked Nov 18, 2026

Published vulnerabilities (OSV.dev)

Not checked yet

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/akalongman-nbg-rates.svg)](https://mcp.popnx.com/en/servers/akalongman-nbg-rates)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Accounting, finance & taxi

  • More stars than 94% of the other 3417 servers in this category
  • Published to the registry more recently than 92% of the other 3417 servers in this category
  • Basic checks equal to or better than 99% of the other 3417 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is NBG Rates (National Bank of Georgia) safe?

It passed 5 of 5 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

Either way works: install it on your computer or connect to the cloud version.

Is it still maintained?

The GitHub repo last changed 2 days ago, and the latest version (0.7.1) reached the registry 2 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: SolidInvoice, Signal8, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Signal8

SEC filings, dilution, insider & institutional ownership, and political-trade data for AI agents.

by signal8aiGrowing↓ 431/wk★ 425Updated 10 days ago

Computer or cloud✓ service owner · signal8.ai

Journalit

Trading journal in Obsidian. Ask Claude or ChatGPT about your trades; edits are previewed first.

by CursivezGrowing★ 261Updated 11 days ago

Runs in the cloud✓ service owner · journalit.co

Beancount.io

Query, edit, and reconcile a hosted Beancount ledger: BQL, reports, files, and bank imports.

by bex-coGrowing★ 702 Stars for the whole repoUpdated 44 days ago

Runs in the cloud✓ service owner · beancount.io
Compared with similar ones
This one
NBG Rates (National Bank of Georgia)
SolidInvoiceSignal8JournalitBeancount.ioTapetide - Indian Stock Market MCP
Runs whereCloud or install on your computerRuns in the cloud, nothing to installCloud or install on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installCloud or install on your computer
Needs a keyNoNoYesNoNoYes
Add with + in ClaudeNoNoNoNoNoNo
Basic checks5/54/65/54/44/45/5
LicenseMITMITMITNOASSERTIONMITMIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

nbg-rates-mcp

Ask Claude, or any other MCP client, for the official National Bank of Georgia (NBG) rate of the lari (GEL) on any date, or to convert an amount at that rate. nbg-rates-mcp runs on your machine or as a hosted connector you paste into claude.ai or ChatGPT, needs no account and no key, and encodes the rules a raw lookup gets wrong: per-unit values, Tbilisi calendar days, an explicit 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.

[nbg-rates.env.ge](https://nbg-rates.env.ge): what it does and how to add it, in English and Georgian.

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.

What you can ask

  • What was the USD rate on 30 September 2026?
  • Convert 1,500 USD to GEL at the NBG rate of 27 September 2026.
  • Give me the EUR rate for every day of September 2026 as a table.
  • How many US dollars is 1 euro today, at NBG rates?

Write the date with the month as a word, "10 September 2026": 10/09/2026 reads as two different dates.

For the second question the answer is: 27 September 2026 is a Sunday, so the rate in force is the one NBG set for Saturday 26 September, 2.6080 GEL per USD, still valid on Sunday; 1,500 USD = 3,912.00 GEL, and the answer says the rate is carried over from the 26th.

In Claude Desktop the "+" menu of a chat also lists four ready-made questions from this server: today's rates, the rate on a date, converting an amount, and a rates table for a month.

Which rate you get

Georgian accounting and tax reporting use the official NBG rate in force on the date of the transaction. This server returns exactly that rate, the one shown on nbg.gov.ge for the day you name.

Converted amounts come rounded half up to two decimals (resultRounded), the way a ledger posts them, computed exactly from NBG's published figures.

NBG sets rates on business days around 17:00 Tbilisi time, valid from the next calendar day. A Sunday, a Monday or the day after a public holiday has no rate of its own and keeps the last one set; the answer says so (carriedOver) and names the day that rate took effect. A date NBG has not published yet, including tomorrow before about 17:00 Tbilisi time, is answered with an error, never a guess.

Install

claude.ai, Claude mobile and ChatGPT (nothing to install)

Paste this URL as a custom connector:

https://nbg-rates.env.ge/mcp

On claude.ai open Customize, then Connectors, then "+ Add" and "Add custom connector", paste the URL and finish with "Add" (on a Team or Enterprise plan an owner adds it under Organization settings, then Connectors); the connector then also appears in the Claude mobile apps and in Claude Desktop under the same account. In ChatGPT open chatgpt.com/plugins, select the plus button, then "Add custom MCP server", paste the URL under Connection, leave authentication off and finish with "Create as a plugin" (in a workspace, an admin may need to allow custom MCP servers first). The landing page, nbg-rates.env.ge, has step-by-step instructions for each app.

This hosted service is the latest release of this server, run by the maintainer on AWS. It needs no account and never records the amounts or currencies asked; for a past date it keeps a copy of NBG's table the first time anyone asks, and the copy does not say who asked or when. It keeps two logs for 30 days: which tool was called from which client and whether NBG answered, and the gateway's access log (time, path, status, and the caller's IP address and user agent; for claude.ai and ChatGPT the caller is Anthropic's or OpenAI's server). The logs are used only to keep the service running, to see which clients use it and to investigate errors or abuse; they are not sold, shared or used for advertising. The landing page sets no cookies and loads nothing from anyone else.

Claude Desktop (macOS, Windows)

Download nbg-rates-mcp-latest.mcpb and open it. Claude Desktop installs the extension and runs it with its own Node.js, so nothing else is needed. The same file, under its version number, is attached to every release.

Claude Desktop (Linux beta) and manual configuration

Add the server to claude_desktop_config.json. The file may not exist yet; create it with the snippet below as its whole content, then restart Claude Desktop.

PlatformLocation of claude_desktop_config.json
macOS~/Library/Application Support/Claude/
Windows%APPDATA%\Claude\
Linux~/.config/Claude/
{ "mcpServers": { "nbg-rates": { "command": "npx", "args": ["-y", "nbg-rates-mcp"] } } }

This needs Node.js 22 or later; see Node.js below.

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
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.

The rest of this document is for developers and for people writing instructions for a model.

Self-hosting

The same server speaks Streamable HTTP: nbg-rates-mcp --http --port 3000 serves http://127.0.0.1:3000/mcp (add --host 0.0.0.0 to listen on every interface). On AWS Lambda the handler is dist/lambda.handler of the npm package with its production dependencies zipped beside it, behind an API Gateway HTTP API with payload format 2.0 and the $default stage (a named stage prefixes every path with its name, so each request would get a 404). Set NBG_RATES_HTTP_HOSTS to the public host name in either case, so the endpoint answers only for it. Optionally, NBG_RATES_MIRROR_TABLE names a DynamoDB table that the same function fills from NBG on a schedule and then answers from; unset, lookups go to NBG as before.

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.

nbg_get_rates

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:

NameRequiredDescription
datenoCalendar date. Defaults to today in Tbilisi. Tomorrow's rate exists after about 17:00 Tbilisi time.
currenciesnoISO 4217 codes to return, case-insensitive, duplicates ignored, for example ["USD", "EUR"]. When given, the list holds at least one entry. Omit for all currencies.
languagenoLanguage of the currency names: en (default) or ka (Georgian). Codes, numbers and dates are the same in both.

Output:

  • requestedDate: the date asked for, or today in Tbilisi when date is omitted.
  • effectiveDate: the date the returned rates took effect, as NBG publishes it.
  • carriedOver: true when the rates in force on requestedDate took effect on an earlier day. They are still the official rates for requestedDate; quote effectiveDate alongside them.
  • rates: one entry per currency with code, name, rate (GEL per one unit), diff (change versus the previous published rate, per one unit), nbgQuantity (the units NBG quotes the raw rate for: 1, 10, 100, 1000 or 10000) and nbgRate (the raw rate as NBG publishes it, for nbgQuantity units). Values below 0.000001, mostly the diff of a currency quoted per 1000 or 10000 units, are JSON numbers in exponent notation, for example 4e-7.
  • unknownCodes: requested codes NBG did not quote on that date, and inputs that are not a three-letter currency code at all. The other requested codes are still answered. GEL is listed here too: every rate is in GEL, so the table has no row for it.

Worked example: on Monday 2026-10-05 a user asks for the AMD rate on Sunday 2026-10-04. NBG sets no rate for a Sunday, so the rate in force is the one valid from Saturday 2026-10-03, which NBG quotes as 7.1762 GEL per 1000 drams. The request

{ "date": "2026-10-04", "currencies": ["AMD"] }

returns

{

"requestedDate": "2026-10-04", "effectiveDate": "2026-10-03", "carriedOver": true, "rates": [ { "code": "AMD", "name": "Armenian Dram", "rate": 0.0071762, "diff": 0.000012, "nbgQuantity": 1000, "nbgRate": 7.1762 } ], "unknownCodes": [] }

The same request for Monday 2026-10-05 returns the same rate with requestedDate 2026-10-05: the rate NBG set on Friday for Saturday is still in force on Monday.

nbg_convert

Converts an amount between two currencies with the official NBG rate in force on a calendar date. Either side may be GEL; a pair without GEL is converted through GEL.

Inputs:

NameRequiredDescription
amountyesAmount in the from currency. A finite number, may be negative.
fromyesISO 4217 code, or GEL.
toyesISO 4217 code, or GEL.
datenoCalendar date whose official rate to apply. Defaults to today in Tbilisi.

Output:

  • amount, from, to: the request, with the codes in upper case.
  • result: the converted amount, unrounded, for further calculation.
  • resultRounded: the exact amount rounded half up to two decimals, computed from NBG's published figures; the amount to show. JSON drops trailing zeros, so 3.90 arrives as 3.9.
  • rate: one unit of from expressed in to.
  • via: direct when either side is GEL (or both codes are the same), GEL when a pair without GEL is converted through GEL.
  • requestedDate, effectiveDate, carriedOver: as in nbg_get_rates.

GEL to GEL is the identity and needs no NBG rate, so it answers for any valid date. A code NBG did not quote on the date is an error.

`nbg_convert_

Only the beginning is shown; read the rest in the repo