MCP server

geonames-mcp-server

io.github.cyanheads/geonames-mcp-server

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Search GeoNames places, walk admin hierarchies, reverse geocode, get postal codes and country info.

Source

At a glance

Type

MCP server

Publisher

Not verified

Status

Working at last check

Tools

8

Token cost

About 7,303 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http geonames-mcp-server https://geonames.caseyjhand.com/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.geonames-mcp-server]
url = "https://geonames.caseyjhand.com/mcp"

Gemini CLI

{"mcpServers":{"geonames-mcp-server":{"httpUrl":"https://geonames.caseyjhand.com/mcp"}}}

Cursor

{"mcpServers":{"geonames-mcp-server":{"url":"https://geonames.caseyjhand.com/mcp"}}}

VS Code

{"servers":{"geonames-mcp-server":{"type":"http","url":"https://geonames.caseyjhand.com/mcp"}}}

Antigravity

agy mcp add geonames-mcp-server https://geonames.caseyjhand.com/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"geonames-mcp-server","server_url":"https://geonames.caseyjhand.com/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"geonames-mcp-server","server_url":"https://geonames.caseyjhand.com/mcp"}

Tools

• geonames_find_postal_codes ~1073 tokens
  Look up postal codes in the GeoNames postal database (122 countries): mode code resolves a postal code to its place, admin names, and centroid; mode place_name finds postal codes for a place name; both page with offset, up to 5000; mode nearby lists postal codes within radiusKm (up to 30 km) of a co
• geonames_get_children ~893 tokens
  List the direct children of a GeoNames feature — Earth's continents, a continent's countries, a country's first-level divisions, a state's counties, a city's sections — in the administrative tree, or in the tourism tree (islands, coasts, and their municipalities; almost all in Spain) or the dependen
• geonames_get_countries ~627 tokens
  Get GeoNames country facts — ISO alpha-2, alpha-3, and numeric codes, FIPS code, geonameId, capital, population, area in km², continent, languages, currency, postal-code format, and mainland bounding box — for the countries named, a continent, or all 250. The geonameId anchors geonames_get_children
• geonames_get_hierarchy ~316 tokens
  Return the parent chain of a GeoNames feature, ordered from Earth and its continent through the country and admin divisions down to the feature itself, each with its geonameId, feature code, and coordinates. Use it to find which country, state, and county contain a place, or to fill an admin path fo
• geonames_get_place ~516 tokens
  Fetch the full GeoNames record for one geonameId: coordinates, feature type, the admin chain with each level's code, name, and geonameId, timezone, bounding box, recorded and DEM elevation, population, Wikipedia URL, names in other languages, postal codes, and external identifiers (IATA, ICAO, UN/LO
• geonames_list_reference ~592 tokens
  Decode GeoNames vocabulary used by the other tools: topic feature_classes lists the 9 one-letter classes; topic feature_codes lists the 684 feature codes with names and definitions, filterable by class and text; topic postal_countries lists the 122 countries with postal-code data and each one's code
• geonames_reverse_geocode ~1271 tokens
  Resolve a latitude/longitude to the country and admin subdivisions that contain it (down to ADM5, each with its geonameId and ISO 3166-2 code where one exists), or the ocean or sea when the point is offshore, plus the nearest populated places with distances; these include neighborhood sections (PPLX
• geonames_search_places ~2015 tokens
  Search the GeoNames gazetteer of 13M+ places by name and filters: country, admin division by its GeoNames code (adminCode1 TX with countries US for Texas), feature class (P populated places, A admin divisions, T mountains and terrain, H water, S buildings and spots), feature code (PPLC capitals, ADM

Browse

• GitHub tools
• Website monitoring
• GitHub and code hosting
• Databases
• Maps and places

Related MCP servers

• ISHOB Knowledge Archive
  License-checked research archive and technical-spec search for AI agents. Pay per call via x402.
• API Acre
  73 x402-paid Base and Solana APIs with free discovery, samples, workflows, and Pixel Acre.
• CycleCalcs Astronomy
  Read-only astronomy calculations: sun, moon, planets, eclipses, twilight and star positions.
• Tanod Sky
  Aviation and space data: METAR/TAF, airports, space weather, aurora, asteroids, satellite passes.
• Geoapify MCP by usefulapi
  Geocode, reverse-geocode, autocomplete, route and search places.
• Geonames
  GeoNames MCP — GeoNames geographical database API
• TidyData Tools
  Holidays, business days, currency, time zones, DNS/WHOIS, web page checks, geodata and text tools.
• Citiview Agent Market
  186 pay-per-call tools: search, LLMs, UK KYB, FRED, Census, maps, crypto. x402 USDC.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.cyanheads/geonames-mcp-server.svg)](https://aptlynx.net/servers/io.github.cyanheads/geonames-mcp-server)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents