Georgia MCP

Why

Georgian public data is spread over many sites: the National Bank, each commercial bank, each fuel company, the Tbilisi Transport Company. Georgia MCP reads them for your model, so you can ask one question and get one answer.

• Read-only. Every tool reads public data and changes nothing.
• Sourced. Every answer names its source and the time of the data, so you can check it.
• Exact. A rate or a price is a decimal string, never a rounded float.
• No account. The hosted server needs no sign-in and no key.

What you can ask

What is the official USD to GEL rate today?

Which bank buys euros at the best rate right now?

Where is diesel cheapest in Georgia?

When does the next bus reach my stop?

Which TBC Bank card offers give a discount at restaurants?

Subject	Sources
Exchange rates	National Bank of Georgia, Bank of Georgia, TBC Bank, Liberty Bank, Terabank, Halyk Bank, Basisbank, Credo Bank, Rico Credit, Scapp, MJC, Inteli Express, MBC, Crystal, Kursi.ge
Fuel prices	SOCAR, Wissol, Gulf, Rompetrol, Lukoil, Portal, Connect, Neogas
Card offers	Bank of Georgia, TBC Bank, Liberty Studio
Tbilisi public transport	Tbilisi Transport Company
Postal codes	Georgian Post
Cinemas	Cavea
Statistics and inflation	Geostat

Install

The hosted server runs at:

https://geo-mcp.abgeo.cloud/mcp

Claude

Open Georgia MCP in the Claude directory and select Connect. It then works on claude.ai, Claude Desktop, and the Claude mobile apps.

Claude Code

If you added Georgia MCP on claude.ai, it is already in Claude Code under the same account. Run /mcp to check: it is listed as claude.ai Georgia MCP. To add it yourself, for example when you sign in with an API key, run:

claude mcp add --transport http georgia-mcp https://geo-mcp.abgeo.cloud/mcp

ChatGPT

Open Plugins, select +, then Add custom MCP server. Paste the address above and set the authentication to None. A custom server needs a paid plan.

Cursor

Add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "georgia-mcp": { "url": "https://geo-mcp.abgeo.cloud/mcp" }
  }
}

VS Code

Add this to .vscode/mcp.json in your project:

{
  "servers": {
    "georgia-mcp": { "type": "http", "url": "https://geo-mcp.abgeo.cloud/mcp" }
  }
}

Run it yourself

With Docker:

docker run -p 8080:8080 ghcr.io/abgeo/georgia-mcp

Then connect your client to http://localhost:8080/mcp.

With a release binary, over stdio: download the archive for your system from the latest release, unpack it, and put georgia-mcp on your PATH. Then run:

claude mcp add georgia-mcp -- georgia-mcp stdio

Each release signs checksums.txt with cosign and carries build provenance. Each check also proves that the workflow of this repository built the file from the tag. To check an archive, run:

gh attestation verify georgia-mcp_<version>_linux_amd64.tar.gz --owner ABGEO \
  --signer-workflow ABGEO/georgia-mcp/.github/workflows/release.yml

Or check the checksums with cosign, then the archive:

cosign verify-blob checksums.txt --bundle checksums.txt.sigstore.json \
  --certificate-identity "https://github.com/ABGEO/georgia-mcp/.github/workflows/release.yml@refs/tags/v<version>" \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com
sha256sum --ignore-missing -c checksums.txt

To check an image:

cosign verify ghcr.io/abgeo/georgia-mcp:<version> \
  --certificate-identity "https://github.com/ABGEO/georgia-mcp/.github/workflows/images.yml@refs/tags/v<version>" \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com

Each archive and each image comes with an SPDX SBOM.

With Go, over stdio:

go install github.com/abgeo/georgia-mcp/cmd/georgia-mcp@latest
claude mcp add georgia-mcp -- georgia-mcp stdio

Three sources need a key, so they are off by default. To turn one on, set its switch to true and its key:

Source	Switch	Key
Tbilisi Transport Company	GEOMCP_TRANSIT_TTC_ENABLED	GEOMCP_TRANSIT_TTC_API_KEY
TBC Bank developer API	GEOMCP_RATES_TBC_ENABLED	GEOMCP_RATES_TBC_API_KEY
Credo Bank rates API	GEOMCP_RATES_CREDO_ENABLED	GEOMCP_RATES_CREDO_API_KEY

configs/.env.example lists every setting.

Tools

Tool	Answers
rates_get_official_rates	The official rate of the lari for today or a past date.
rates_list_official_history	The official rate of one currency for each day of a period.
rates_get_commercial_rates	The buy and sell rates of the commercial banks right now.
fuel_get_prices	Today's fuel prices of each company, grouped by grade.
offers_search_offers	The current card offers of the banks.
offers_get_offer	The full terms of one card offer.
transit_search_stops	Stops of Tbilisi by name or code.
transit_list_nearby_stops	Stops near a point, nearest first.
transit_list_arrivals	The next vehicles at a stop, live.
transit_search_routes	Routes of Tbilisi by number or name.
transit_get_route	One route with each direction and every stop.
transit_get_timetable	The planned departures of a route from one stop.
transit_search_places	A place in Tbilisi by name or address.
transit_plan_trip	A trip by public transport between two points of Tbilisi.
postal_search_codes	The postal code of an address, a street, a town, or a village.
cinema_list_cinemas	The open cinemas of Cavea.
cinema_list_movies	The movies of Cavea, now showing or coming soon.
cinema_search_movies	The movies of Cavea by a part of the English name.
cinema_list_sessions	The sessions of one date, with the prices and the occupancy.
cinema_get_seat_map	The seats of one session, with the free seats of each class.
stats_search_tables	The statistical tables of Geostat by words of the title or the folder.
stats_get_table	One table of Geostat with its dimensions and their values.
stats_get_cells	The figures of one table of Geostat for a selection.
stats_get_inflation	The inflation of Georgia for a month, a city, and a price group.
air_get_quality	The newest air quality readings of a city, a station, or every station.
air_list_history	The hourly air quality readings of one station over at most 7 days.

The website shows the input and a real output of each tool.

Development

Georgia MCP follows spec driven development. The code comes from the documents in docs/specs/. Read that guide before you open a pull request.

You need Go (the version in go.mod) and Task.

cp configs/.env.example .env  # then fill in the keys
task run                      # serve over HTTP on :8080
task lint test build          # check the server
task test:live                # run the tests against the real sources

Each vendor client is a package under pkg/<vendor> that another project can import. task --list shows every task.

Contributing

Bug reports and ideas are welcome in issues, and questions in Q&A. To add a source or a tool, open an issue first: each one starts as a requirements document. Read the contributing guide before you open a pull request.

Privacy and security

The hosted server keeps an access log and a record of each tool call, never the input of a call. Read the privacy policy and the terms of service.

To report a vulnerability, follow the security policy. Please don't open a public issue.

Disclaimer

Georgia MCP is not an official service. It is not affiliated with the National Bank of Georgia or any bank, fuel company, transport operator, postal operator, cinema chain, or statistics office it reads. The data belongs to its publishers and can be late or wrong. Check with the source before you decide.

Author

Made with ❤️ in Georgia by Temuri Takalandze (ABGEO).

License

Georgia MCP is free software under the GNU General Public License v3.0.