930m310n avatar

Geomelon Mcp

930m310n/geomelon-mcp

Wraps the Geomelon geographic API from RapidAPI and exposes cities, countries, regions, and languages as MCP tools. You can search cities by name, country, or coordinates, calculate distances between locations, fetch administrative regions, and pull translations in multiple languages. Includes compound tools that chain calls for things like finding nearby cities or building a full country overview with regions and top cities. Ships with both stdio for Claude Desktop and HTTP transport for Claude Code or remote hosting. Requires a RapidAPI key to access the Geomelon API, though there's also a free oneshot prefix search endpoint you can call directly without authentication.

GitHub stars
1
tools
22
auth
Secret needed
transport
STDIO
env vars
2
last updated
Jul 17, 2026

Tools

22 tools

Public tool metadata for what this MCP can expose to an agent.

search_citiesSearch by name, country code, region, population range, sort order

Search by name, country code, region, population range, sort order

No parameter schema in public metadata yet.

get_cityFull details for a city by UUID

Full details for a city by UUID

No parameter schema in public metadata yet.

get_city_translationsAll name translations for a city by UUID

All name translations for a city by UUID

No parameter schema in public metadata yet.

get_city_settlement_typesSettlement-type classifications for a city by UUID

Settlement-type classifications for a city by UUID

No parameter schema in public metadata yet.

cities_by_coordinates_closestCities nearest to a lat/lon, ordered by distance

Cities nearest to a lat/lon, ordered by distance

No parameter schema in public metadata yet.

cities_by_coordinates_largestLargest cities near a lat/lon, ordered by population

Largest cities near a lat/lon, ordered by population

No parameter schema in public metadata yet.

cities_distanceDistance in km between two cities

Distance in km between two cities

No parameter schema in public metadata yet.

list_countriesList countries, filter by name prefix or telephone dialing code

List countries, filter by name prefix or telephone dialing code

No parameter schema in public metadata yet.

get_countryFull details for a country by UUID (includes translations and regions)

Full details for a country by UUID (includes translations and regions)

No parameter schema in public metadata yet.

get_country_translationsName translations for a country by UUID

Name translations for a country by UUID

No parameter schema in public metadata yet.

get_country_regionsAll administrative regions for a country by UUID

All administrative regions for a country by UUID

No parameter schema in public metadata yet.

list_regionsList regions, filter by country UUID

List regions, filter by country UUID

No parameter schema in public metadata yet.

get_regionFull details for a region by UUID

Full details for a region by UUID

No parameter schema in public metadata yet.

get_region_translationsName translations for a region by UUID

Name translations for a region by UUID

No parameter schema in public metadata yet.

list_languagesList all languages in the database

List all languages in the database

No parameter schema in public metadata yet.

get_languageDetails for a language by UUID

Details for a language by UUID

No parameter schema in public metadata yet.

search_cities_autocompleteCountry-scoped, language-specific city name prefix search backed by pre-built static files

Country-scoped, language-specific city name prefix search backed by pre-built static files

No parameter schema in public metadata yet.

find_cities_near_cityGiven a city UUID, find nearby cities ordered by distance or population

Given a city UUID, find nearby cities ordered by distance or population

No parameter schema in public metadata yet.

city_contextFetch a city together with its full country and region details in one call

Fetch a city together with its full country and region details in one call

No parameter schema in public metadata yet.

country_overviewFetch a country (by UUID or name), its regions, and top cities by population

Fetch a country (by UUID or name), its regions, and top cities by population

No parameter schema in public metadata yet.

compare_citiesFetch two cities and the distance between them in one call

Fetch two cities and the distance between them in one call

No parameter schema in public metadata yet.

search_cities_in_countrySearch cities using a country name instead of an ISO code

Search cities using a country name instead of an ISO code

No parameter schema in public metadata yet.

Sponsors

Configuration

GEOMELON_API_KEYsecret

Your RapidAPI key for Geomelon. Optional: without it the server runs in keyless demo mode, exposing only the free search_cities_autocomplete tool.

PORTsecret

Port to run HTTP MCP on

Readme

geomelon-mcp

MCP server for the Geomelon geographic API. Exposes cities, countries, regions, and languages as tools any MCP-compatible AI client can call.

Looking for other ways to integrate? See all official libraries at geomelon.dev/libraries.

Two transports are included:

BinaryTransportUse case
geomelon-mcpstdioClaude Desktop, Cursor, Cline, Continue
geomelon-mcp-httpHTTP (Streamable)Claude Code, remote / hosted server

Requirements


Keyless demo mode

No GEOMELON_API_KEY? Run the server anyway — it starts up with just the search_cities_autocomplete tool, backed by the free oneshot host, no signup required. Every other tool needs a key. This is the fastest way to try the server before subscribing on RapidAPI.

Try it with zero setup


View the full README on GitHub

Details

Repository
github.com/930m310n/geomelon-mcp
Package
geomelon-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active