A Go API server with MCP (Model Context Protocol) support, providing a template for building MCP servers with HTTP transport, bearer token authentication, and rate limiting.
Single tool with clear naming (get_service_status) and good description (72 chars). Input schema is empty object (valid but minimal). Output schema is well-structured with typed fields (status, service, version, started_at, now). Tool is read-only and properly annotated. However, the server is a template with only one trivial tool; lacks real-world complexity. Description could be more specific about use cases. No parameter descriptions needed (empty input), but output fields lack inline documentation.
Return service identity, version, start time, and current server time.
Output schema fields lack descriptions. LLMs cannot infer what 'status', 'service', 'version', 'started_at', 'now' represent without inline documentation.
Tool description (72 chars) is minimal and does not explain WHEN to call this tool or what the agent should do with the response. Should clarify: 'Use to verify service health and uptime before making requests. Returns service name, version, startup time, and current UTC time for latency calculation.'
Server is a template with only one trivial tool. No guidance on how to add real application tools, parameter validation, or error handling patterns. The serverInstructions mention 'Add product tools in internal/mcp' but provide no examples.
Inferred effective spec: 2026-07-28+.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 66 | 2026-07-28+ | v2 |