Two read-only tools with basic schemas and minimal descriptions. Both tools have proper JSON Schema with types and required fields, but descriptions are generic (under 100 chars) and lack context about when to use each tool or what they return. Parameters have descriptions but lack format constraints (ISO 8601 dates should specify format). No output schema documented. No error handling guidance. No parameter validation rules stated. Naming is clear (list_events, get_event) but descriptions don't explain the distinction or use cases.
Get details of a specific calendar event by ID
List calendar events within a date range
No output schema documented. LLMs cannot plan downstream calls or extract fields without knowing what list_events and get_event return.
Descriptions are generic and under 100 chars. They state WHAT the tools do but not WHEN to use them or how they differ. 'List calendar events within a date range' doesn't explain whether this returns summaries or full details, or when to call get_event instead.
Date parameters lack format constraints. 'Start of the date range in ISO 8601 format' is stated in description but not enforced in schema. Should include 'format': 'date-time' in JSON Schema.
No error handling guidance. If calendar_id is invalid or event_id doesn't exist, the tool will fail with no recovery hint for the LLM.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 62 | 2026-07-28+ | v2 |
No pagination support in list_events. Large date ranges could return hundreds of events, blowing context window. Should accept limit and page/offset parameters.