Express middleware library for MCP (Model Context Protocol) OAuth authentication
Single tool 'github_me' with minimal definition. Tool has a clear verb-noun name and basic description, but parameter annotations are completely absent. Input schema is present but empty (no parameters to describe). No output schema documented. No error handling guidance. This is a barebones implementation that does not follow LLM-optimized tool definition patterns.
Get the authenticated user's GitHub profile information
No output schema documented. LLM cannot plan follow-up actions or extract structured data from response. Returns plain text instead of typed fields.
Tool description is 50 characters and lacks context on when to use it vs other GitHub tools, what it requires, or what fields it returns. Should be 100-200 chars with usage guidance.
Error handling is present in implementation but not declared in tool schema. LLM cannot distinguish between success and error responses or understand recovery paths. Error response format should be documented.
Tool assumes OAuth token is available via 'authInfo?.token' but this dependency is never declared in description. LLM should know this tool requires prior authentication.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | D | 55 | <=2025-11-25 | v2 |
| 2026-03-09 | F | 44 | - | v1 |
No tool annotations (readOnlyHint, idempotentHint) despite being read-only and idempotent. Modern MCP spec supports tool annotations via capabilities.