Deterministic readiness checker for the MCP 2026-07-28 specification break
This is a migration checker tool, not a production MCP server. The 8 tools are test fixtures across multiple languages (TypeScript, Python, Go, Rust) demonstrating migration readiness patterns. Most tool definitions lack proper schemas and descriptions. search_documents, list_notes, read_note have minimal descriptions (10-50 chars, below the 50-200 char baseline). Schemas are inferred from fixture code rather than explicitly registered. No error handling guidance, no output schema documentation, no parameter validation hints. The tools are intentionally varied to test the checker's detection logic, not to exemplify quality.
Append a note to a folder.
Advance a multi-step task and return the next handle.
Echo a message
List note titles under a folder.
List note titles under an explicitly provided folder.
Read one note by its absolute path.
Full-text search across the tenant's document set.
Descriptions critically short (10-25 chars). Baseline is 50-200 chars. LLMs cannot determine when/why to select tools.
No input schemas visible in source code. Tool definitions inferred from fixture code rather than explicitly registered with JSON Schema.
Duplicate tool name 'list_notes' appears twice (notes-mcp fixture). Ambiguous naming forces LLM to guess which variant to call.
No output schemas documented. LLMs cannot plan downstream calls or extract required fields (e.g., does search_documents return IDs for follow-up read_note calls?).
Inferred effective spec: 2026-07-28+.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 39 | 2026-07-28+ | v2 |
Summarize a topic
No error handling guidance. Tools provide no recovery hints (e.g., 'folder not found, try list_notes() first').