Stateless, read-only MCP server providing advisory, validation, and migration services for the MCP Server Development Methodology
Server has 11 tools with basic schemas and descriptions, but quality is inconsistent. 8 methodology tools (evaluate_gate, get_migration_report, etc.) have reasonable descriptions (60-120 chars) and input schemas with enums for response_format. However, 3 example tools (hello, echo, echo_structured) are trivial and lack depth. No output schemas documented for any tool. Parameter descriptions are minimal, most lack guidance on valid ranges, formats, or dependencies. No error handling guidance visible. Tool names follow verb_noun pattern (good), but descriptions don't explain WHEN to use each tool or what downstream tools they chain to. Missing: pagination guidance, idempotency hints, and recovery instructions.
Echo back the input text
Echo back structured input
Evaluate a gate against client state. Returns pass/fail status with detailed check results.
Get advisory suggestions for a specific context (phase or node). Returns examples, templates, anti-patterns, and success criteria.
Get detailed diff between two catalog versions. Shows phases, nodes, gates, and advisory changes.
Generate migration report from one catalog version to another. Analyzes compatibility, changes, and state updates.
Get detailed information about a specific node including status, evidence, and advisory.
Get detailed information about a specific phase including nodes and advisory.
No output schemas documented. LLMs cannot plan downstream tool calls or extract required fields without knowing response structure.
Parameter descriptions lack actionable constraints. 'context' in get_advisory_suggestions has no format guidance (phase_id vs node_id format). 'from_version' and 'to_version' lack version format specification.
No error handling guidance. Tools lack recovery instructions (e.g., 'If version not found, call list_versions() first'). No indication of retryable vs fatal errors.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 43 | 2026-07-28+ | v2 |
Simple hello world tool
List all nodes in the current catalog, optionally filtered by phase.
List all phases in the current catalog with their metadata.
Trivial example tools (hello, echo, echo_structured) lack meaningful descriptions and serve no domain purpose. Should be removed or replaced with real methodology tools.
No pagination or result-limiting guidance. list_phases and list_nodes lack limit/offset parameters and total count documentation, risking context window exhaustion.