MCP server for accessing Fathom API data and OpenStreetMap geolocation services
Three tools with basic verb-noun naming (get_*). All have descriptions (10-50 chars, below baseline 194 chars). Input schemas present with typed parameters and descriptions. However, descriptions are minimal and lack context for LLM selection. No output schemas documented. No error handling guidance. No parameter constraints (enums, ranges). Missing idempotency hints and dependency documentation. Composition is sound (each tool does one thing), but descriptions do not explain WHEN to use each tool or what downstream tools expect.
Retrieves the bounding box of a city by name from OpenStreetMap.
Retrieves Fathom data for a specific location and layer.
Gets a layer ID from the given return period and year
Descriptions are 25-50 characters, well below baseline 194 chars. Lack context for LLM selection. 'Gets a layer ID from the given return period and year' does not explain WHEN to call this vs other tools, what the return value is used for, or dependencies.
No output schemas documented. LLMs cannot plan downstream calls or extract required fields. get_fathom_data returns MessageToDict(points_response), structure unknown. get_city_bounding_box returns Tuple[float, float], unclear if (lat, lon) or (lon, lat). get_layer_id returns str, no format hint.
No parameter constraints. 'type' parameter in get_layer_id accepts free-form string; description says '(FLUVIAL, PLUVIAL, COASTAL)' but no enum enforced. LLMs will hallucinate invalid values. latitude/longitude lack range hints (±90, ±180).
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 49 | 2026-07-28+ | v2 |
No error handling guidance. If Fathom API fails, OpenStreetMap returns 404, or layer_id is invalid, LLMs receive raw exceptions with no recovery hints. No actionable error messages.
Tool composition lacks chaining hints. get_city_bounding_box returns center coordinates, but get_fathom_data expects latitude/longitude, no documentation that the first tool's output feeds the second. Agents must infer this relationship.