Read-only MCP tools for evidence-linked inspection of a software workspace.
Six tools with consistent schemas and descriptions, but significant gaps in naming clarity and parameter documentation. All tools follow a uniform pattern (repository + taxonomy filters) which aids consistency but reduces specificity. Descriptions are adequate (100-150 chars) but lack actionable context for LLM selection. No output schemas documented. Error handling and recovery guidance absent. Tools 1-5 have identical input structures, suggesting potential over-generalization; tool 6 (brain_reframe) shows better parameter differentiation with enum constraints and pattern validation.
Analyzes prediction and feedback data from your analytics database to detect integration gaps and pipeline health issues.
Inspects GitHub issues and local git branches to identify unpushed work and open items requiring triage.
Scans for machine learning model artifacts in configured directories and reports their presence and metadata.
Synthesizes evidence from analytics, models, backlog, and roadmap to produce ranked recommendations for system improvement.
Applies a mental model lens to a recommendation or task context to surface alternative perspectives and evidence-based reasoning.
Extracts roadmap and backlog notes from architecture documentation to identify planned work and open items.
Tools 1-5 lack verb-noun naming convention. 'brain_analytics' is a noun phrase; should be 'analyze_brain' or 'get_analytics'. LLMs infer intent from action verbs, noun-only names reduce clarity.
No output schemas documented for any tool. LLMs cannot plan downstream calls or extract fields without knowing response structure. Descriptions mention 'reports', 'metadata', 'recommendations' but never specify returned fields.
Parameter descriptions are generic and lack actionable constraints. 'Systems to analyze (from taxonomy)' does not explain what 'systems' means, when to use it, or how it filters results. No examples of valid values in descriptions.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 54 | 2026-07-28+ | v2 |
No error handling or recovery guidance. Tools do not document what happens on missing repository, invalid taxonomy values, or data unavailability. LLMs have no guidance on retry vs. user correction.
brain_reframe requires 'recommendationKey' but no tool documents how to obtain valid keys. No discovery tool lists available recommendations. LLMs cannot infer valid keys without prior context.