Two tools with basic schemas and descriptions. Both tools have input schemas (one with optional parameter, one empty), descriptions present but minimal (10-20 chars), and tool annotations (readOnlyHint). However, parameter descriptions are sparse, output schemas are not documented, and error handling guidance is absent. The 'start' tool accepts an optional 'name' parameter with a description, but 'get-fortune-cookie' has no parameters documented. No pagination, no error recovery patterns, no output field documentation. Meets baseline for a demo but lacks production-grade rigor.
Get fortune cookie
Onboard Skybridge
Output schemas not documented. Tools return structuredContent with fields like 'prediction' and 'name', but LLMs cannot infer what fields to expect or how to chain results to downstream tools.
Tool descriptions are too brief (10-20 chars). 'Get fortune cookie' and 'Onboard Skybridge' lack context on WHEN to use them, WHAT they return, or any prerequisites. LLMs cannot reliably select these tools without richer descriptions (target 50-200 chars).
No error handling or recovery guidance. If 'start' fails or 'get-fortune-cookie' times out, the LLM has no actionable next step. Error responses should categorize failures as retryable, user-fixable, or fatal.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 46 | 2025-06-18+ | v2 |
'get-fortune-cookie' has no input parameters documented, yet the tool likely has internal state or configuration. If parameters exist, they must be declared in the schema; if none, the schema is correct but should be explicit.
No composition guidance. The 'start' tool returns a 'name' field; downstream tools or views that depend on this should be documented. No chaining IDs or references provided for multi-step workflows.