Georgia MCP

Official registry Other

An MCP server for Georgian public data, read from the organizations that publish it.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code
claude mcp add --transport http georgia-mcp 'https://geo-mcp.abgeo.cloud/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "georgia-mcp": {
            "type": "http",
            "url": "https://geo-mcp.abgeo.cloud/mcp"
        }
    }
}
OCI package ghcr.io/abgeo/georgia-mcp:1.1.0
Claude Code
claude mcp add georgia-mcp -e 'GEOMCP_TRANSIT_TTC_ENABLED=<GEOMCP_TRANSIT_TTC_ENABLED>' -e 'GEOMCP_TRANSIT_TTC_API_KEY=<your geomcp_transit_ttc_api_key>' -e 'GEOMCP_RATES_TBC_ENABLED=<GEOMCP_RATES_TBC_ENABLED>' -e 'GEOMCP_RATES_TBC_API_KEY=<your geomcp_rates_tbc_api_key>' -e 'GEOMCP_RATES_CREDO_ENABLED=<GEOMCP_RATES_CREDO_ENABLED>' -e 'GEOMCP_RATES_CREDO_API_KEY=<your geomcp_rates_credo_api_key>' -- docker run -i --rm ghcr.io/abgeo/georgia-mcp:1.1.0 stdio
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "georgia-mcp": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/abgeo/georgia-mcp:1.1.0",
                "stdio"
            ],
            "env": {
                "GEOMCP_TRANSIT_TTC_ENABLED": "<GEOMCP_TRANSIT_TTC_ENABLED>",
                "GEOMCP_TRANSIT_TTC_API_KEY": "<your geomcp_transit_ttc_api_key>",
                "GEOMCP_RATES_TBC_ENABLED": "<GEOMCP_RATES_TBC_ENABLED>",
                "GEOMCP_RATES_TBC_API_KEY": "<your geomcp_rates_tbc_api_key>",
                "GEOMCP_RATES_CREDO_ENABLED": "<GEOMCP_RATES_CREDO_ENABLED>",
                "GEOMCP_RATES_CREDO_API_KEY": "<your geomcp_rates_credo_api_key>"
            }
        }
    }
}

Environment variables

  • GEOMCP_TRANSIT_TTC_ENABLED Turns on the Tbilisi Transport Company. Set it to true with the key.
  • GEOMCP_TRANSIT_TTC_API_KEY secret The key of the Tbilisi Transport Company API.
  • GEOMCP_RATES_TBC_ENABLED Turns on the TBC Bank developer API. Set it to true with the key.
  • GEOMCP_RATES_TBC_API_KEY secret The key of the TBC Bank developer API.
  • GEOMCP_RATES_CREDO_ENABLED Turns on Credo Bank. Set it to true with the key.
  • GEOMCP_RATES_CREDO_API_KEY secret The key of the Credo Bank API.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Georgia MCP
  2. Why
  3. What you can ask
  4. Install
  5. Tools
  6. Development
  7. Contributing
  8. Privacy and security
  9. Disclaimer
  10. Author
  11. License

Georgia MCP

Georgia's public data, inside your chat.

An MCP server for Georgian public data, read from the organizations that publish it.

Ask Claude, ChatGPT, or any MCP client in your own words.

Website · Claude directory · Install · Tools · Report a bug

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?

SubjectSources
Exchange ratesNational 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 pricesSOCAR, Wissol, Gulf, Rompetrol, Lukoil, Portal, Connect, Neogas
Card offersBank of Georgia, TBC Bank, Liberty Studio
Tbilisi public transportTbilisi Transport Company
Postal codesGeorgian Post
CinemasCavea
Statistics and inflationGeostat

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. To check an archive, run:

gh attestation verify georgia-mcp_<version>_linux_amd64.tar.gz --owner ABGEO

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:

SourceSwitchKey
Tbilisi Transport CompanyGEOMCP_TRANSIT_TTC_ENABLEDGEOMCP_TRANSIT_TTC_API_KEY
TBC Bank developer APIGEOMCP_RATES_TBC_ENABLEDGEOMCP_RATES_TBC_API_KEY
Credo Bank rates APIGEOMCP_RATES_CREDO_ENABLEDGEOMCP_RATES_CREDO_API_KEY

configs/.env.example lists every setting.

Tools

ToolAnswers
rates_get_official_ratesThe official rate of the lari for today or a past date.
rates_list_official_historyThe official rate of one currency for each day of a period.
rates_get_commercial_ratesThe buy and sell rates of the commercial banks right now.
fuel_get_pricesToday's fuel prices of each company, grouped by grade.
offers_search_offersThe current card offers of the banks.
offers_get_offerThe full terms of one card offer.
transit_search_stopsStops of Tbilisi by name or code.
transit_list_nearby_stopsStops near a point, nearest first.
transit_list_arrivalsThe next vehicles at a stop, live.
transit_search_routesRoutes of Tbilisi by number or name.
transit_get_routeOne route with each direction and every stop.
transit_get_timetableThe planned departures of a route from one stop.
transit_search_placesA place in Tbilisi by name or address.
transit_plan_tripA trip by public transport between two points of Tbilisi.
postal_search_codesThe postal code of an address, a street, a town, or a village.
cinema_list_cinemasThe open cinemas of Cavea.
cinema_list_moviesThe movies of Cavea, now showing or coming soon.
cinema_search_moviesThe movies of Cavea by a part of the English name.
cinema_list_sessionsThe sessions of one date, with the prices and the occupancy.
cinema_get_seat_mapThe seats of one session, with the free seats of each class.
stats_search_tablesThe statistical tables of Geostat by words of the title or the folder.
stats_get_tableOne table of Geostat with its dimensions and their values.
stats_get_cellsThe figures of one table of Geostat for a selection.
stats_get_inflationThe inflation of Georgia for a month, a city, and a price group.
air_get_qualityThe newest air quality readings of a city, a station, or every station.
air_list_historyThe 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.

Frequently asked questions

What is Georgia MCP?

An MCP server for Georgian public data, read from the organizations that publish it.

How do I install Georgia MCP?

It runs as a remote server. In Claude Code: claude mcp add --transport http georgia-mcp 'https://geo-mcp.abgeo.cloud/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Georgia MCP need an API key?

Yes. It expects GEOMCP_TRANSIT_TTC_API_KEY, GEOMCP_RATES_TBC_API_KEY, GEOMCP_RATES_CREDO_API_KEY, which you set in its configuration.

Is Georgia MCP open source?

Yes. Its code is on GitHub under the GPL-3.0 license.

Who maintains Georgia MCP?

It is published by abgeo. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.