geonames-mcp-server
v0.1.3Search GeoNames places, walk admin hierarchies, reverse geocode, get postal codes and country info.
Endpoint health
online- Last checked
- 11/20/2026, 9:18:05 AM
- Latency
- 257 ms
- Consecutive failures
- 0
- Endpoint reachable: pass
- Protocol valid: pass
- MCP handshake valid: pass
Machine-readable profile
mcp-server · schema v1 · callable
mcp-server:io.github.cyanheads%2Fgeonames-mcp-server
Connect this server
Generated config contains no credentials. Keep any required secrets in your client's local environment.
{
"mcpServers": {
"io.github.cyanheads/geonames-mcp-server": {
"url": "https://geonames.caseyjhand.com/mcp"
}
}
}Indexed tools
Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
8 shown · authentication unknown
Find GeoNames postal codes
geonames_find_postal_codes
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 coordinate, nearest first. Ireland returns only Eircode routing keys and Malta only the letter prefix; the United Kingdom (GB), Canada, and the Netherlands hold both full codes and their outward or district prefixes. Check coverage with geonames_list_reference topic postal_countries. Costs 1 GeoNames credit (2 for nearby); a code or place_name lookup with countries that returns nothing at offset 0 also reads the postal coverage list, 1 more credit unless that list is cached. Repeat lookups are cached.
Schema valid · SHA-256 d190e5ac87fc…
View input schema
{ "type": "object", "properties": { "mode": { "description": "What to look up. code: the place for postalCode (required). place_name: the postal codes of placeName (required). nearby: postal codes around lat and lng (both required; countries not accepted).", "type": "string", "enum": [ "code", "place_name", "nearby" ] }, "postalCode": { "description": "Postal code to resolve, such as 98101, SW1A 1AA, or K1A 0A1: capital letters, digits, spaces, and hyphens, up to 12 characters. Required in mode code; in mode place_name it narrows the match; not used in mode nearby.", "type": "string", "pattern": "^[A-Z0-9][A-Z0-9 -]{0,11}$" }, "placeName": { "description": "Place name to find postal codes for, up to 100 characters. GeoNames matches it against place, admin, and country names. Required in mode place_name; in mode code it narrows the match; not used in mode nearby.", "type": "string", "maxLength": 100 }, "lat": { "description": "Latitude in decimal degrees, -90 to 90. Required in mode nearby.", "type": "number", "minimum": -90, "maximum": 90 }, "lng": { "description": "Longitude in decimal degrees, -180 to 180. Required in mode nearby.", "type": "number", "minimum": -180, "maximum": 180 }, "radiusKm": { "description": "Search radius in kilometres for mode nearby, above 0 and at most 30 (GeoNames' free-tier limit). Default 10.", "default": 10, "type": "number", "exclusiveMinimum": 0, "maximum": 30 }, "countries": { "description": "Countries to look up postal codes in: ISO 3166-1 codes, up to 10, as a list: alpha-2 (US, GB, DE), alpha-3 (USA, GBR, DEU), or three-digit numeric (840, 826, 276), each sent to GeoNames as alpha-2. UK is accepted for GB and FL for LI. A listed country also returns the territories GeoNames files under it (GB also returns IM, JE, and GG), each postal code's countryCode naming its own country. Modes code and place_name only.", "maxItems": 10, "type": "array", "items": { "type": "string", "pattern": "^([A-Z]{2,3}|\\d{3})$", "description": "ISO 3166-1 alpha-2, alpha-3, or three-digit numeric country code." } }, "limit": { "description": "Maximum entries to return, 1 to 1,000. This tool returns at most 100 per call: a larger limit is held to 100, and the notice says so when more entries remain. Default 10.", "default": 10, "type": "integer", "minimum": 1, "maximum": 1000 }, "offset": { "description": "Postal codes to skip before the first one returned, 0 to 5000. Default 0. Modes code and place_name only; pass the nextOffset of the previous page to read the next one.", "default": 0, "type": "integer", "minimum": 0, "maximum": 5000 }, "geonamesUsername": { "description": "Your own GeoNames username, so the call spends that account's free credits instead of the server's. Omit it to use the server's account. The account needs free web services enabled on its geonames.org account page.", "type": "string", "pattern": "^\\S{1,64}$" } }, "required": [ "mode" ], "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false }
Connections
streamable-http
https://geonames.caseyjhand.com/mcp