Geomelon MCP server
io.github.930m310n/geomelon-mcp·v1.1.1·1 starsMCP server for the Geomelon geographic API — stdio and remote HTTP transports
1 stars74 downloads/wk
Reviews
Write oneNobody has reviewed Geomelon yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Geomelon tools (22)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
cities_by_coordinates_closestFind cities nearest to given coordinates, ordered by distance.
cities_by_coordinates_largestFind the largest cities near given coordinates, ordered by population.
cities_distanceCalculate the distance in kilometres between two cities.
city_contextGet a city together with its full country and region details in one call.
compare_citiesFetch full details for two cities and the distance between them in one call.
country_overviewGet a country's details, all its regions, and its most populous cities in one call. Accepts either a country UUID or a name prefix.
find_cities_near_cityFind cities near a given city. Resolves the city's coordinates and returns nearby cities ordered by distance or population.
get_cityGet full details for a single city by its UUID.
get_city_settlement_typesGet settlement-type classifications for a city (e.g. city, town, village) by its UUID.
get_city_translationsGet all available name translations for a city by its UUID.
get_countryGet full details for a single country by its UUID, including translations and regions.
get_country_regionsGet all administrative regions belonging to a country by its UUID.
get_country_translationsGet name translations for a country by its UUID.
get_languageGet details for a single language by its UUID.
get_regionGet full details for a single region by its UUID.
get_region_translationsGet name translations for a region by its UUID.
list_countriesList countries with optional filtering by name prefix or telephone code. Supports localized names via preferredLanguages.
list_languagesList languages available in the Geomelon database.
list_regionsList administrative regions, optionally filtered by country.
search_citiesSearch cities by name, country, population range, and more. Returns matching cities with geographic and translation data.
search_cities_autocompleteFast country-scoped, language-specific city name prefix search backed by pre-built static files. Works without a Geomelon API key. Returns up to 10 cities sorted by population, with the requested language name and an English fallback.
search_cities_in_countrySearch cities using a country name instead of an ISO code. Resolves the country first, then searches cities within it.
Public scan report
scanner v0.1.9 · 2026-09-25 · same rubric, same numbers if you re-run it
- Code scan3 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 70 days ago12/15
- Maintainer identityregistry namespace matches repository owner7/10
How Geomelon compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 77/100
- higher than 50% of 48,255 servers
- Tools
- 22
- the typical server has 7
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 1
- more than 65% of 28,688 servers
- Downloads a week
- 74
- more than 55% of 12,191 servers with a package
What its tools let an agent do: 22 read
Install Geomelon in Claude Code, Cursor or VS Code
Runs npx -y geomelon-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add geomelon-mcp -- npx -y geomelon-mcp
What the publisher says
From the Geomelon repository's README, as published. We do not edit it. Read it on GitHub
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:
Requirements
- Node.js 18+
- A RapidAPI key with the Geomelon API subscribed — optional, see keyless demo mode below
Keyless demo mode
No GEOMELONAPIKEY? Run the server anyway — it starts up with just the searchcitiesautocomplete 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
Geomelon also runs a public hosted instance of this same keyless demo — no npx, no local process. Point any remote-MCP-capable client (Claude web/desktop connectors, ChatGPT connectors, MCP Inspector, etc.) at:
https://mcp.geomelon.dev/mcpIt exposes only searchcitiesautocomplete, same as running the server yourself with no API key. For the full 22-tool set, run your own instance (below) with your RapidAPI key.
Claude Code (HTTP)
Create a .env file in the directory you'll run the server from:
cp .env.example .env
# then edit .env and set GEOMELON_API_KEYStart the server (dotenv loads .env automatically):
npx geomelon-mcp-httpRegister it with Claude Code:
claude mcp add --transport http geomelon http://localhost:3000/mcpVerify it's connected:
claude mcp listThe server must be running whenever you use Claude Code. To use a different port set PORT=your_port and update the URL in the claude mcp add command accordingly.
Claude Desktop (stdio)
Add to ~/Library/Application Support/Claude/claudedesktopconfig.json:
{
"mcpServers": {
"geomelon": {
"command": "npx",
"args": ["-y", "geomelon-mcp"],
"env": {
"GEOMELON_API_KEY": "your_rapidapi_key_here"
}
}
}
}Restart Claude Desktop after saving.
Cursor / Windsurf / Cline (stdio)
Add to your editor's MCP config:
{
"geomelon": {
"command": "npx",
"args": ["-y", "geomelon-mcp"],
"env": {
"GEOMELON_API_KEY": "your_rapidapi_key_here"
}
}
}Remote / hosted HTTP server
Create a .env file on your server:
cp .env.example .env
# set GEOMELON_API_KEY and PORT in .envStart the server:
npx geomelon-mcp-httpThen register with any MCP client using http://your-host:3000/mcp as the URL.
The HTTP transport is stateless — each request is independent, no session management needed. CORS is wide open (Access-Control-Allow-Origin: *) since this transport is meant to be reachable by browser-based remote-MCP clients too. GET / (or /health) returns a small JSON status object — useful for uptime checks — reporting whether the instance has a key configured ("mode": "full" or "mode": "keyless-demo").
Available tools
Cities
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Geomelon: common questions
- Is Geomelon MCP server safe?
- Mostly: it is graded B (77/100). Read the Geomelon safety report
- How do I install Geomelon?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Geomelon need an API key?
- Yes. The registry entry asks for
GEOMELON_API_KEY,PORT. - Is Geomelon maintained?
- The last commit was 110 days ago (2026-07-17). The latest release is v1.1.1.
- How does Geomelon compare with other MCP servers?
- safety score 77/100 (higher than 50% of 48,255 servers); tools 22 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.