Multi-project MCP server providing centralized access to story management, knowledge base, project context, workflows, and documentation across all registered projects
Server defines 5 tools with action-based dispatch via ConsolidatedTool pattern. All tools have descriptions (10-200 chars) and flat input schemas listing all possible parameters. However, critical gaps undermine quality: (1) Tool names lack action verbs, 'stories', 'knowledge', 'projects', 'workflow', 'docs' are nouns, not verb_noun patterns like 'list_stories' or 'search_knowledge'. LLMs struggle to infer intent from noun-only names. (2) Parameter descriptions are minimal (5-30 chars); many lack format/constraint guidance. (3) Output schemas are undocumented, no evidence of return type definitions. (4) Error handling is absent, no recovery guidance or actionable error messages visible. (5) Consolidated tool pattern uses flat schema with runtime validation, which is pragmatic but obscures required-per-action semantics from the LLM.
Document graph operations with actions: get document content, get document context and related documents
Manage knowledge base with actions: search knowledge base, get detailed knowledge entry, record lesson learned, record decision, record pattern
Manage projects with actions: list all registered projects, get project information, get related documentation, search across projects
Manage stories with various actions: list stories with optional filters, get specific story by ID, create new story from template, update specific section of story
Manage workflows with actions: list available workflows, start a workflow, complete workflow step, get workflow status
Tool names are nouns, not action verbs. 'stories', 'knowledge', 'workflow' lack verb prefixes (list_, search_, create_, update_). LLMs cannot infer intent from noun-only names and must read full descriptions to disambiguate.
Parameter descriptions are minimal (5-30 chars) and lack format/constraint guidance. E.g., 'status' has no enum values listed; 'priority' lacks valid options; 'template_type' undocumented. LLMs cannot validate inputs without explicit constraints.
Output schemas are not documented. No evidence of return type definitions, field names, or structure. LLMs cannot plan downstream tool calls or extract required data without knowing what fields to expect.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 44 | 2026-07-28+ | v2 |
No error handling or recovery guidance visible. Tools lack actionable error messages, categorization (retryable vs fatal), or suggestions for next steps. Agents cannot self-correct on failures.
Consolidated tool pattern uses flat schema with runtime validation. All possible parameters listed in one schema; required-per-action constraints enforced at runtime. This obscures action-specific requirements from the LLM and prevents schema-level validation.