A template/starter kit for building MCP servers with HTTP and stdio transports, API key and OAuth authentication, and audit logging.
Single tool 'whoami' with empty input schema and minimal description. No parameter documentation, no output schema specification, no error handling guidance. The tool definition is visible in server.ts but lacks the rigor expected for production. Description is 95 chars (within acceptable range) but provides no context on when to use it, what it returns, or how to handle errors. Input schema is completely empty ({}), violating the requirement that every parameter be described. No tool annotations present.
Check the API key is valid and return the key name + its scopes.
Empty input schema: tool 'whoami' has no parameters defined, violating the requirement that schemas include type definitions and descriptions.
No output schema documented: tool response structure is not specified, forcing LLMs to infer what fields are returned.
No error handling guidance: tool description does not explain what errors can occur (e.g., invalid API key) or how to recover.
Tool name 'whoami' does not follow verb_noun convention; 'check_api_key' or 'get_current_user' would be clearer.
No tool annotations: missing readOnlyHint, destructiveHint, or idempotentHint metadata to guide agent behavior.
Inferred effective spec: 2026-07-28+.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 39 | 2026-07-28+ | v2 |