A secure MCP server starter template in Go with HTTP transport, CORS support, and optional Bearer token authentication
Single tool 'add' has a clear, concise description and properly typed input parameters with descriptions, but lacks critical elements for production MCP use: no output schema documentation, no error handling guidance, minimal description depth, and no composition hints. The tool is simple arithmetic (verb + noun naming is correct), but provides no actionable recovery information if something fails. Input schema is present and complete with descriptions for both parameters, meeting baseline requirements for a minimal tool. However, the description lacks depth on when to use this tool, any prerequisites, or what happens on error.
Add two integers.
Tool description is too generic and lacks actionable context. 'Add two integers.' (22 chars) does not explain when to use this tool, whether it's meant for calculations in a larger workflow, or what happens if overflow occurs. Baseline: descriptions should be 34-392 chars with WHAT/WHEN/PREREQUISITES structure.
No output schema documented. The tool returns a TextContent with formatted text result, but there is no formal schema definition in the tool registration describing the output structure. LLMs cannot plan downstream calls or extract results reliably without knowing return types.
No error handling or recovery guidance. If integer overflow occurs, what error is returned? How should the LLM handle it? The code provides no error classification (retryable vs fatal), no actionable error messages, and no recovery hints. Agents have no guidance.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | F | 11 | <=2025-11-25 | v2 |
| 2026-03-09 | F | 48 | - | v1 |
Tool serves no clear business purpose in this starter template. A single 'add' tool suggests proof-of-concept rather than production readiness. The tool's identity in a larger system is unclear, is it for math calculations, data transformation, or system testing? Add purpose context to the description.