Integration

GeoDB Cities integration

GeoDB Cities is a global database of cities, towns, administrative divisions and countries, refreshed from GeoNames and WikiData. Search places by name prefix (autocomplete), country, time zone, type, population or distance from a point or another place; read a country, region, division or place in detail; compute the distance between two places and get a place's current local time; list currencies, languages, locales and time zones. Places are addressed by their GeoDB id or their WikiData id (Q90 is Paris). Every tool is read-only, and the separate GraphQL flavour of the API is not covered. The API is sold through RapidAPI: authentication is your RapidAPI key, subscribed to GeoDB Cities, sent in the X-RapidAPI-Key header; the largest page your plan allows sets the useful limit.

Connect GeoDB Cities How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in GeoDB Cities.Built from the 39 GeoDB Cities tools below, on the connection you add once.

What you can do with GeoDB Cities

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Nearby place, 4 operations

list_admin_division_nearby_placesList admin division nearby placesGETFind places near the given administrative division, filtering by optional criteria. If no criteria are set, you will get back all known places.
list_city_nearby_placesList city nearby placesGETFind places near the given city, filtering by optional criteria. If no criteria are set, you will get back all places within the default radius.
list_location_nearby_placesList location nearby placesGETFind places near the given location, filtering by optional criteria. If no criteria are set, you will get back all places within the default radius.
list_place_nearby_placesList place nearby placesGETFind places near the given place, filtering by optional criteria. If no criteria are set, you will get back all places within the default radius.

Place, 4 operations

get_placeGet placeGETGet place details such as location coordinates, population, and elevation above sea-level (if available).
list_country_placesList country placesGETGet the country's places. The country is omitted in the response.
list_region_placesList region placesGETGet country region places. The country and region info is omitted in the response.
search_placesSearch placesGETFind places, filtering by optional criteria. If no criteria are set, you will get back all known places.

Admin division, 3 operations

get_admin_divisionGet admin divisionGETGet administrative division details such as location coordinates, population, and elevation above sea-level (if available).
list_region_admin_divisionsList region admin divisionsGETGet country region administrative divisions. The country and region info is omitted in the response.
search_admin_divisionsSearch admin divisionsGETFind administrative divisions, filtering by optional criteria. If no criteria are set, you will get back all known divisions.

City, 3 operations

get_cityGet cityGETGet city details such as location coordinates, population, and elevation above sea-level (if available).
list_region_citiesList region citiesGETGet country region cities. The country and region info is omitted in the response.
search_citiesSearch citiesGETFind cities, filtering by optional criteria. If no criteria are set, you will get back all known cities.

Date time, 3 operations

get_city_date_timeGet city date timeGETReturns the current local date and time in the city's time zone, as an ISO-8601 timestamp with its UTC offset.
get_place_date_timeGet place date timeGETReturns the current local date and time in the place's time zone, as an ISO-8601 timestamp with its UTC offset.
get_timezone_date_timeGet timezone date timeGETReturns the current local date and time in a time zone, as an ISO-8601 timestamp with its UTC offset.

Nearby city, 3 operations

list_admin_division_nearby_citiesList admin division nearby citiesGETFind cities near the given administrative division, filtering by optional criteria. If no criteria are set, you will get back all known cities.
list_city_nearby_citiesList city nearby citiesGETFind cities near the given city, filtering by optional criteria. If no criteria are set, you will get back all cities within the default radius.
list_location_nearby_citiesList location nearby citiesGETFind cities near the given location, filtering by optional criteria. If no criteria are set, you will get back all cities within the default radius.

Nearby division, 3 operations

list_admin_division_nearby_divisionsList admin division nearby divisionsGETFind administrative divisions near the given division, filtering by optional criteria. If no criteria are set, you will get back all known divisions.
list_city_nearby_divisionsList city nearby divisionsGETFind administrative divisions near the given city, filtering by optional criteria. If no criteria are set, you will get back all divisions within the default radius.
list_location_nearby_divisionsList location nearby divisionsGETFind administrative divisions near the given location, filtering by optional criteria. If no criteria are set, you will get back all divisions within the default radius.

Time, 3 operations

get_city_timeGet city timeGETReturns the current local time of day in the city's time zone (hours, minutes, seconds), without the date.
get_place_timeGet place timeGETReturns the current local time of day in the place's time zone (hours, minutes, seconds), without the date.
get_timezone_timeGet timezone timeGETReturns the current local time of day in a time zone (hours, minutes, seconds), without the date.

Country, 2 operations

get_countryGet countryGETReturns one country's details: ISO code, name, capital, calling code, currency codes, flag image, number of regions and WikiData id.
list_countriesList countriesGETFind countries, filtering by optional criteria. If no criteria are set, you will get back all known countries.

Distance, 2 operations

get_city_distanceGet city distanceGETReturns the straight-line distance between two cities, in miles by default or in kilometers with distanceUnit=KM.
get_place_distanceGet place distanceGETReturns the straight-line distance between two places, in miles by default or in kilometers with distanceUnit=KM.

Located in, 2 operations

get_city_located_inGet city located inGETGet the details for the containing populated place (e.g., its county or other administrative division), including location coordinates, population.
get_place_located_inGet place located inGETGet the details for the containing populated place (e.g., its county or other administrative division), including location coordinates, population.

Region, 2 operations

get_regionGet regionGETGet country region details such as number of cities.
list_country_regionsList country regionsGETGet the country's regions. These could be states, provinces, districts, or otherwise major political divisions.

Timezone, 2 operations

get_timezoneGet timezoneGETReturns one time zone: its id, its name and its offset from UTC in hours.
list_timezonesList timezonesGETLists the time zones GeoDB knows, with their id (the slash written as two underscores, for example Europe__Paris), name and UTC offset in hours. The ids feed timeZoneIds filters and get_timezone.

Currency, 1 operation

list_currenciesList currenciesGETLists currencies with their ISO-4217 code, symbol and the countries that use them. Pass countryId to get only the currencies used in one country; omit it to page through every currency.

Language, 1 operation

list_languagesList languagesGETLists the languages GeoDB can display place names in, with their code and name; the code is the value to pass as languageCode on the search and detail tools.

Locale, 1 operation

list_localesList localesGETLists the locales GeoDB knows, each with its code and name (for example sr_ME, Serbian (Montenegro)).

Use GeoDB Cities from Claude Code, Cursor or Codex

Connect GeoDB Cities in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its GeoDB Cities operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect GeoDB Cities

Create your workspace
Sign up free. Nothing to install.
Connect GeoDB Cities once
Add your GeoDB Cities connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.