A demonstration MCP server with multiple example implementations including document assistant, weather forecasting, and basic calculation tools
Server has 4 tools with basic schemas and descriptions, but significant gaps limit production readiness. All tools have descriptions (10-50 chars) and input schemas with type definitions, but descriptions are too brief to guide LLM selection effectively. calculate_sum and weather tools are read-only and well-scoped; edit_file is a write operation but lacks error guidance and confirmation patterns. No tool annotations (readOnlyHint, destructiveHint). Output schemas are undocumented. Parameter descriptions exist but are minimal. No pagination, no batch operations, no recovery guidance for failures.
Add two numbers
Asynchronously appends a line of text to the end of a file.
Get weather alerts for a US state.
Get weather forecast for a location.
Descriptions too brief (10-50 chars). LLMs need 50-200 char descriptions to disambiguate tools and understand when to call them. 'Add two numbers' and 'Get weather alerts for a US state' lack context on prerequisites, return format, and when to use vs similar tools.
edit_file is a destructive write operation but lacks confirmation pattern, dry-run option, or error recovery guidance. No indication that this operation is irreversible or how to undo it.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). LLMs cannot distinguish safe read-only tools from destructive ones without explicit hints.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 47 | <=2025-11-25 | v2 |
Output schemas undocumented. calculate_sum returns int, edit_file returns None, weather tools return strings, but LLMs have no formal schema to parse responses or plan downstream calls.
get_alerts and get_forecast return unstructured strings. Should return structured JSON with typed fields (event, severity, temperature, etc.) so LLMs can extract and reason about individual fields.