MCP server for Intentloom - a vendor-neutral local framework for defining, validating, and synchronizing engineering intent across AI coding tools
All 7 tools have basic schemas and descriptions, but quality is inconsistent. Tool names lack action verbs (inspect, doctor, timeline are nouns/descriptors rather than verb_noun patterns). Descriptions are present but generic (10-50 chars, well below the 50-200 char LLM-optimized baseline). Parameter descriptions exist but are minimal. No output schemas documented. All tools are read-only, which is good for safety, but error handling and recovery guidance are absent. No tool annotations (readOnlyHint, etc.) despite all being read-only. Schemas are present but sparse, most parameters lack constraints, enums, or detailed format guidance.
Read-only engineering conformance report
Read-only project doctor diagnosis
Read-only project inspection
Read-only persistent memory search
Read-only structured project diff plan
Read-only security finding inspection
Read-only bounded project timeline
Tool names lack action verbs. 'inspect', 'doctor', 'timeline', 'projectDiff' are nouns/descriptors, not verb_noun patterns. LLMs infer intent from names, 'get_project_inspection', 'run_project_diagnosis', 'list_project_timeline' would be clearer.
Descriptions are too short (10-50 chars vs. 50-200 char baseline). 'Read-only project inspection' and 'Read-only project doctor diagnosis' lack context for when/why to call them. No guidance on what each returns or how they differ.
No output schemas documented. LLMs cannot plan downstream calls or extract data without knowing response structure. All 7 tools lack return type documentation.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 45 | 2026-07-28+ | v2 |
No tool annotations despite all being read-only. Missing readOnlyHint annotations would signal to agents that these tools are safe to call without side-effect concerns.
Parameter constraints missing. 'limit' and 'maxItems' lack min/max bounds; 'query' has no length constraints; 'policy' and 'timeline' objects lack schema definitions. Free-form parameters invite invalid LLM inputs.