MCP server that provides GitHub activity information for standup status reports
Single tool with adequate naming (GetUserActivity starts with verb) but significant gaps in schema documentation and parameter descriptions. Input schema visible but minimal, only 'since' parameter with basic type info. No output schema documented. Description is present (34 chars) but below the 50-200 char LLM-optimized baseline. No error handling guidance, no pagination support despite potentially returning many events, no tool annotations. Follows basic tool structure but lacks production-grade rigor.
Get the current user's recent activity on GitHub
Output schema not documented. LLMs cannot plan downstream calls or extract structured data from GitHub activity results. Tool returns unstructured markdown string instead of typed objects.
Tool description is 34 characters, below the 50-char minimum for LLM clarity. 'Get the current user's recent activity on GitHub' lacks context on WHEN to use it, what it returns, or how it differs from other GitHub tools.
No pagination support. Tool can return unbounded activity lists, risking context window exhaustion. No limit parameter, no cursor/offset, no total count in response.
Parameter 'since' description is minimal ('Get events since this date in local time (optional)'). No guidance on format, timezone handling, or what happens if omitted. LLMs may pass invalid datetime formats.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 44 | <=2025-11-25 | v2 |
No error handling guidance. Tool returns plain strings on empty results or failures. LLMs cannot distinguish between 'no activity' and 'API error' or know whether to retry.