Multi-agent orchestration MCP server with context store, message broker, and agent registry for coordinating Claude Code agents across multiple roles (developer, architect, teamlead, qa, productowner)
Five tools with complete JSON schemas and descriptions, but significant gaps in parameter documentation and error guidance. invoke_agent and context_store have clear enums and required fields, but context_query, context_summarize, and context_stats lack actionable descriptions for their parameters. No output schemas documented. Error handling is absent, tools do not guide recovery or categorize failures. Naming is verb-forward (invoke_, context_*) but descriptions are terse (10-50 chars), below the 50-200 char baseline for LLM-optimized tools. No tool annotations (readOnlyHint, destructiveHint, idempotentHint). Composition is reasonable, each tool has one responsibility, but parameter relationships (e.g., correlationId required only for conversation scope) are underdocumented.
Query the context store by keys, search, or get-all
Get aggregate statistics for stored context
Store a context item in the shared context store
Summarize conversation context by truncation (POC)
Invoke another agent through the message broker
Parameter descriptions are missing or generic. 'mode' in context_query lacks explanation of what 'keys', 'search', 'get-all' do. 'maxTokens' is unexplained. LLMs cannot infer parameter semantics from names alone.
No output schemas documented. Tools return data but LLMs do not know what fields to expect. Downstream tool chaining is impossible without trial-and-error.
No error handling guidance. Tools do not indicate what errors are retryable, user-fixable, or fatal. No recovery hints (e.g., 'If correlationId is invalid, call context_query first').
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 47 | 2026-07-28+ | v2 |
Tool descriptions are too short (10-50 chars). Below the 50-200 char baseline for LLM-optimized tools. 'Store a context item in the shared context store' does not explain WHEN to use this vs invoke_agent, or what happens on TTL expiry.
Parameter dependencies undocumented. context_query requires 'correlationId' only for conversation scope, but this is not stated. context_summarize has no required params but 'correlationId' is needed for conversation scope, ambiguous.