MCP server for searching family-friendly activities and travel destinations using the Famxplor API
Single tool with adequate naming and schema, but significant gaps in parameter descriptions and output documentation. Tool name 'search_family_activities' follows verb_noun convention. Input schema is present with 4 parameters, all typed as float/string. However, parameter descriptions are minimal (10-15 chars each), falling below the 72-char baseline. No output schema documented, LLMs cannot plan downstream operations. Error handling returns generic strings ('Unable to fetch activities') without recovery guidance. No pagination despite potentially returning multiple results. Lacks tool annotations (readOnlyHint present in metadata but not in schema). Overall quality is below median for production tools.
Retrieves family activities that are geographically close to the specified location.
Parameter descriptions are too brief (10-15 chars). 'Latitude of the location.' and 'Longitude of the location.' lack context on valid ranges, precision, or coordinate system (WGS84 assumed but not stated).
No output schema documented. Tool returns a formatted string with activity details, but LLMs cannot parse structure or plan chaining. Should document: returns array of {title, url, img_url, lat, lon} or equivalent structured format.
No pagination support. Tool may return many activities but lacks limit/offset parameters or result count. Large result sets will bloat context and degrade LLM reasoning.
Error messages are generic and non-actionable. 'Unable to fetch activities' and 'No activities found' do not guide the LLM on recovery steps (retry, adjust parameters, check API status).
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 58 | <=2025-11-25 | v2 |
Tool description lacks WHEN to use it and prerequisites. Does not mention that user_query is used for filtering (semantic search?) or how it interacts with lat/lon/max_dist. Ambiguous whether all parameters are required.