akalongman/nbg-rates-mcp

GEL exchange rates from the National Bank of Georgia (NBG) for AI agents (MCP server). Not affiliated with NBG.

Before you install: a copy-paste command is available · license MIT · link reachable

no SECURITY.md

View on GitHub ↗Link checked 2026-11-12 · HTTP 200 · opens the vendor's own site

checked 2026-11-14 — requires Node >=22 (LTS since Oct 2024); a note, not a failure.

Install & config

Copy the command above
Paste it as one entry under mcpServers in claude_desktop_config.json — local servers take command + args (example: clients)
Restart your client

Remote endpoint (mcpServers - Claude Desktop / Cursor / Windsurf)

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

Paste this into the mcpServers config of Claude Desktop or Cursor. The endpoint comes from public evidence; we do not install or host it. Official Registry record: this endpoint lists no request headers. That is not the same as key-free - the project docs decide.

VS Code (.vscode/mcp.json - the key is servers, remote needs type: http)

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

VS Code differs from the other three: the top-level key is <code>servers</code> and a remote endpoint also needs <code>"type": "http"</code>. Paste into .vscode/mcp.json.

Claude Code (command line)

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

Claude Code does not read a config file; add the server with this command.

Client config (built from the install command this repo gives)

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

Parsed from the README we fetched on 2026-10-26; we have not executed it.

command/args come from the install command the repository states. When it is ambiguous, the project README wins.

VS Code (.vscode/mcp.json - the key is servers)

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

Same server, but VS Code keeps it under <code>servers</code>.

Claude Code (command line)

claude mcp add --transport stdio akalongman-nbg-rates-mcp -- npx -y nbg-rates-mcp

Claude Code does not read a config file; add the server with this command.

Key names differ by client: Clients & CLI

Star count: 3 ★ · akalongman/nbg-rates-mcp · read from the GitHub search API · (checked 2026-11-13 20:00:50)
Source: collected from the punkpeye/awesome-mcp-servers list · type: MCP server
Harvest history: first seen 2026-10-23 · last seen 2026-11-14 · seen 26× · listed by 23 sources
Score: score 2,300 · 3 ★ · 23 sources · mcp
Install: npx -y nbg-rates-mcp

FAQ (answers come from our records)

How do I install it?

The repository provides this install command: npx -y nbg-rates-mcp. It comes from the repository itself; we cannot guarantee it runs as-is in your client.

Who is it for?

We filed it under these tags: MCP 服务. The tags come from the entry itself, not a taxonomy we imposed.

Who maintains it?

repository akalongman/nbg-rates-mcp；first catalogued 2026-10-23；last seen 2026-11-14。There is no official certification or quality rating here — we record sources and dates only.

# nbg-rates-mcp

以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →

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

Listed badge (optional)

Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.

[![Listed on Anclum](https://anclum.com/badge/listed.svg)](https://anclum.com/en/s/akalongman-nbg-rates-mcp/)

Source: awesome · https://github.com/akalongman/nbg-rates-mcp
Browse by field: MCP servers
Traction: 3 ★
Listed by: 23 independent sources
added: today
Security policy: no SECURITY.md at the repository root (which does not mean it is unsafe)

More like this

microsoft/playwright-mcpMCP server rohitg00/kubectl-mcp-serverMCP server portainer/portainer-mcpMCP server

All 6,229 →

Filed under

MCP servers6,229 entries MCP server6,545 Curated list pick6,618

Every tag opens the full list for that filter. Counts are the live catalogue figures.

Browse all fields →

← Back to index