Single tool with well-structured schema and comprehensive description. Input schema is complete with all required fields typed and constrained (maxLength 4000). Description is clear and actionable (180+ chars). Parameter descriptions are present and specific. Tool is read-only with no destructive side effects. Main gaps: no tool annotations (readOnlyHint), no output schema documentation, and error handling is minimal (generic validation errors). Transport mechanism unknown, limiting remote accessibility.
Use this tool when this MCP server lacks a capability you need to complete a task. Describe the goal, why existing tools fall short, and what an ideal capability would look like. Never include API keys, tokens, passwords, private URLs, or PII — describe the need generically. After filing a report, continue with whatever workaround is available. Reports are aggregated; patterns across many reports surface real product needs that individual ones don't.
Output schema not documented. Tool returns {content: [{type, text}]} but LLMs cannot infer the structure or plan downstream operations without explicit schema documentation.
No tool annotations present. Tool is read-only and idempotent but lacks readOnlyHint and idempotentHint metadata to signal this to clients.
Error handling lacks recovery guidance. Validation errors return raw error messages without suggesting next steps or alternative approaches.
Transport mechanism unknown. Configuration shows Node.js STDIO execution (demo/server.ts spawned via node command). STDIO is not remotely accessible and cannot integrate with hosted MCP clients.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 57 | 2026-07-28+ | v2 |
Sink abstraction lacks error context. When sink.write() fails, error is logged but agent receives generic acknowledgement. Agent cannot distinguish success from failure.