How do I use geomelon-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@geomelon-mcp search for cities named London" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

geomelon-mcp

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

Two transports are included:

Binary	Transport	Use case
`geomelon-mcp`	stdio	Local clients — Claude Desktop, Cursor, Cline, Continue
`geomelon-mcp-http`	HTTP (Streamable)	Remote / hosted server

Requirements

Node.js 18+
A RapidAPI key with the Geomelon API subscribed

Setup

Copy .env.example to .env and fill in your key:

cp .env.example .env

GEOMELON_API_KEY=your_rapidapi_key_here
PORT=3000   # HTTP transport only

Local usage (stdio)

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "geomelon": {
      "command": "npx",
      "args": ["-y", "geomelon-mcp"],
      "env": {
        "GEOMELON_API_KEY": "your_rapidapi_key_here"
      }
    }
  }
}

Cursor / Windsurf / Cline

Add to your editor's MCP config (exact path varies by editor):

{
  "geomelon": {
    "command": "npx",
    "args": ["-y", "geomelon-mcp"],
    "env": {
      "GEOMELON_API_KEY": "your_rapidapi_key_here"
    }
  }
}

Remote usage (HTTP)

Start the server:

GEOMELON_API_KEY=your_key PORT=3000 npx geomelon-mcp-http

Then point your MCP client at http://your-host:3000/mcp.

The HTTP transport is stateless — each request is independent, no sessions to manage.

Available tools

Cities

Tool	Description
`search_cities`	Search by name, country code, region, population range, sort order
`get_city`	Full details for a city by UUID
`cities_by_coordinates_closest`	Cities nearest to a lat/lon, ordered by distance
`cities_by_coordinates_largest`	Largest cities near a lat/lon, ordered by population
`cities_distance`	Distance in km between two cities

Countries

Tool	Description
`list_countries`	List all countries, filter by telephone dialing code
`get_country`	Full details for a country by UUID (includes translations and regions)

Regions

Tool	Description
`list_regions`	List regions, filter by country UUID
`get_region`	Full details for a region by UUID

Languages

Tool	Description
`list_languages`	List all languages in the database
`get_language`	Details for a language by UUID

Development

npm install
npm run build      # compile TypeScript → dist/

Run stdio server directly:

GEOMELON_API_KEY=your_key node dist/stdio.js

Run HTTP server directly:

GEOMELON_API_KEY=your_key PORT=3000 node dist/http.js

This server cannot be installed

F

license - not found

-

quality - not tested

C

maintenance

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

geomelon-mcp

geomelon-mcp

Requirements

Setup

Local usage (stdio)

Claude Desktop

Cursor / Windsurf / Cline

Remote usage (HTTP)

Available tools

Cities

Countries

Regions

Languages

Development

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API