Two tools with minimal definition quality. getJourneys has an empty input schema ({}), violating the requirement that every parameter needs a description. addJourney has three parameters with descriptions, but they lack type constraints (enums, ranges, formats). Descriptions are generic and under 50 chars on average. No output schemas documented. Error handling returns raw error objects instead of actionable guidance. Tool names lack clarity on what 'journey' means in domain context.
Add a journey to the journey API
Get journeys from journey API
getJourneys has empty input schema ({}). Tool provides no parameters but also no documentation of what it returns or when to call it.
addJourney parameters lack type constraints. 'distance' is a string but should specify format (numeric with unit, e.g. '0-9999 km'). 'date' format description is vague ('YYYY-MM-DDT TIME' is not ISO 8601). No enum or pattern validation.
No output schemas documented for either tool. LLMs cannot plan downstream calls or extract structured data. Both tools return raw JSON.stringify() output without field documentation.
Error handling returns raw error objects ('Failed to retrieve journeys from the API: ' + error). Does not categorize errors as retryable/user-fixable/fatal or provide recovery guidance. LLM cannot determine next action.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 34 | 2026-07-28+ | v2 |
Tool descriptions are under 50 characters and lack context. 'Get journeys from journey API' does not explain when to call this vs other tools, what a 'journey' is, or what fields are returned. Does not meet 10-1024 character guideline for clarity.