MCP server for the Geomelon geographic API — stdio and remote HTTP transports
Strong foundation with 16 well-named, read-only tools covering geographic search, lookup, and distance calculations. All tools have descriptions (avg 120 chars) and input schemas with Zod validation. Tool names follow verb_noun pattern (search_cities, get_city, list_countries). Schemas are properly typed with enums where appropriate (sort orders, modes). However, output schemas are not documented, LLMs cannot predict response structure. Error handling is absent; no recovery guidance or validation messages. Parameter descriptions are adequate but lack format/constraint details (e.g., UUID format, coordinate ranges). No pagination guidance despite list_countries accepting limit/offset. Structured output via toolResult() is good but not documented in tool descriptions.
Find cities nearest to given coordinates, ordered by distance.
Find the largest cities near given coordinates, ordered by population.
Calculate the distance in kilometres between two cities.
Find cities near a given city. Resolves the city's coordinates and returns nearby cities ordered by distance or population.
Get full details for a single city by its UUID.
Get settlement-type classifications for a city (e.g. city, town, village) by its UUID.
Output schemas not documented. LLMs cannot predict response structure (fields, types, nested objects). toolResult() wraps responses but tool descriptions do not explain what fields are returned.
No error handling or recovery guidance. Tools lack actionable error messages (e.g., 'UUID not found. Try search_cities() first'). No validation feedback for invalid inputs.
Parameter descriptions lack format/constraint details. UUID parameters do not specify format. Coordinate parameters (lat/lon) lack range constraints (±90/±180). Language codes lack BCP 47 format guidance.
Inferred effective spec: 2025-06-18+.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 59 | 2025-06-18+ | v2 |
Get all available name translations for a city by its UUID.
Get full details for a single country by its UUID, including translations and regions.
Get all administrative regions belonging to a country by its UUID.
Get name translations for a country by its UUID.
Get full details for a single region by its UUID.
Get name translations for a region by its UUID.
List countries with optional filtering by name prefix or telephone code. Supports localized names via preferredLanguages.
List administrative regions, optionally filtered by country.
Search cities by name, country, population range, and more. Returns matching cities with geographic and translation data.
Fast 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.
Pagination tools (list_countries, list_regions, search_cities) accept limit/offset but do not document total count or next_cursor in response. LLMs cannot determine if more results exist.
API key is optional (keyless mode returns only search_cities_autocomplete), but this conditional availability is not documented in tool descriptions. LLMs may attempt unavailable tools.