Log inSubmit server
Geomelon MCP logo

Geomelon MCP

by 930m310n

Geographic MCP tools for cities, countries, regions, languages, translations, proximity searches, and keyless city autocomplete.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Geomelon MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "930m310n-geomelon-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "geomelon-mcp"
      ],
      "env": {
        "GEOMELON_API_KEY": "YOUR_VALUE_HERE",
        "PORT": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

930m310n/geomelon-mcp MCP server exposes Geomelon geographic data through MCP tools for cities, countries, regions, and languages. It supports stdio for local clients and Streamable HTTP for Claude Code or hosted deployments. A RapidAPI Geomelon key enables the full tool set, while keyless demo mode provides only country- and language-scoped city autocomplete. Use it for multilingual geographic lookup, proximity queries, regional context, and city comparison workflows.

Use cases

  • Search cities by multilingual names and country
  • Find nearby cities from coordinates or a known city
  • Compare two cities and calculate their distance
  • Build country overviews with regions and major cities
  • Autocomplete city names without an API key

Key features

  • City, country, region, and language lookup
  • Multilingual geographic names
  • Coordinate proximity and distance queries
  • Compound geographic context tools
  • Keyless city autocomplete
  • Stdio and Streamable HTTP transports

Tools22

What Geomelon MCP lets your agent do. Expand a tool for its parameters.

Self-reported~415 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

18/19 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · geomelon-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads248Package downloads in the last 30 days.
Last commit3mo agoMost recent push to the default branch.
Tools exposed22Callable tools this server registers over MCP.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How Geomelon MCP works

What 930m310n/geomelon-mcp MCP server does

930m310n/geomelon-mcp MCP server connects MCP-compatible clients to the Geomelon geographic API. Its tools cover cities, countries, administrative regions, and languages, including multilingual names across 50 languages. City operations include filtered search, UUID-based lookup, translations, settlement classifications, coordinate-based proximity searches, and distance calculations. Country and region tools support listing, UUID lookup, translations, and relationships between countries and their regions.

The server also includes compound operations that combine related requests. These can return a city with its country and region, assemble a country overview with regions and top cities, compare two cities with their distance, find cities near a known city, or search cities using a country name instead of an ISO code.

How it works

930m310n/geomelon-mcp MCP server provides two transports. The geomelon-mcp binary uses stdio for local integrations such as Claude Desktop, Cursor, Windsurf, and Cline. The geomelon-mcp-http binary provides Streamable HTTP for Claude Code and remote clients.

With GEOMELON_API_KEY configured, the server exposes the full set of geographic tools through the Geomelon API. Without that key, it starts in keyless demo mode and exposes only search_cities_autocomplete. That tool uses pre-built static files for country-scoped, language-specific city-name prefix searches and is also available when a key is configured.

The HTTP transport is stateless, so requests do not depend on a persistent session. Its root and /health endpoints return a small status response that indicates whether the instance is running in full or keyless-demo mode. CORS allows browser-based remote MCP clients to reach the HTTP transport.

Setup and configuration

Running the local stdio server requires Node.js 18 or newer. The full configuration needs a RapidAPI key with the Geomelon API subscribed. For Claude Desktop, Cursor, Windsurf, or Cline, configure the npx -y geomelon-mcp command and pass GEOMELON_API_KEY in the MCP server environment.

The same package can run without the key for autocomplete-only use. A public hosted keyless instance is available at https://mcp.geomelon.dev/mcp, so a remote-capable client can use that endpoint without starting a local process or signing up.

For HTTP operation, run npx geomelon-mcp-http. The default MCP endpoint is /mcp on port 3000. Set PORT when another port is needed, and provide GEOMELON_API_KEY for full access. The server loads values from a .env file when run locally or on a hosted machine.

Tools and capabilities

The 930m310n/geomelon-mcp MCP server includes tools for:

  • Searching cities by name, country, region, population range, and sort order.
  • Looking up city, country, region, and language records by UUID.
  • Retrieving translations and settlement classifications.
  • Finding nearby or largest cities around coordinates.
  • Calculating distance between cities.
  • Listing countries by name prefix or telephone dialing code.
  • Listing regions for a country and languages in the database.
  • Running combined city, country, comparison, and nearby-city queries.
  • Performing fast, keyless city autocomplete for supported country and language pairs.

Limitations and notes

Keyless demo mode does not provide the general city, country, region, language, distance, or compound tools; only search_cities_autocomplete is available. Full access depends on a subscribed RapidAPI Geomelon key. The hosted endpoint is likewise limited to the keyless autocomplete tool. HTTP deployments must remain running for clients to connect, and each HTTP request is independent because the transport does not maintain sessions.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Geomelon MCP

Use Node.js 18 or newer and run `npx -y geomelon-mcp` for the stdio server. Configure `GEOMELON_API_KEY` for the full tool set.

Yes. Configure Claude Desktop to run `npx` with `-y geomelon-mcp` as the package argument. Cursor, Windsurf, and Cline are also listed as stdio clients.

Yes, but only `search_cities_autocomplete` is available in keyless demo mode. A public instance is available at `https://mcp.geomelon.dev/mcp`.

Run `npx geomelon-mcp-http`. The default MCP endpoint is `http://localhost:3000/mcp`; set `PORT` to use another port.

Related MCP servers

All in Location Services All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewGeomelon MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/930m310n-geomelon-mcp?style=directory)](https://allmcps.com/mcp/930m310n-geomelon-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/930m310n-geomelon-mcp"><img src="https://allmcps.com/api/badge/930m310n-geomelon-mcp?style=directory" alt="Geomelon MCP on AllMCPs" /></a>