Rules-pack-agnostic engineering practice audit tool delivered as a local MCP server.
Server has 10 tools with complete input schemas and descriptions present for all. Naming follows verb_noun convention (list_domains, get_domain, begin_run, etc.). However, descriptions are minimal (10-50 chars for most tools), lacking context on WHEN to use each tool, prerequisites, or what happens on failure. Parameter descriptions exist but are terse. No output schemas documented. Error handling guidance is absent. Tools like file_issues and submit_feedback lack confirmation/dry-run patterns despite irreversible/sensitive nature. No tool annotations (readOnlyHint, destructiveHint) visible in schema.
Start a new audit run with metadata
File GitHub issues for audit findings using the user's gh CLI
Poll for configuration data from the user
Get the full text of a domain from the rules pack
List all domains in the loaded rules pack
Record the audit result for a domain
Generate the final audit report
Tool descriptions are too brief (10-50 chars). Missing context on WHEN to call each tool, prerequisites, and what happens on error. LLMs cannot determine tool selection intent from minimal descriptions.
No output schemas documented. LLMs cannot plan downstream tool calls or extract required fields (e.g., what does run_status return? What fields does render_report produce?). Breaks tool chaining.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 64 | 2026-07-28+ | v2 |
Get the current status of an audit run
Start the configuration page for the audit run
Submit feedback about the audit tool to the tool author
Irreversible operations (file_issues, submit_feedback) lack confirmation or dry-run patterns. Agents can accidentally file GitHub issues or send feedback without explicit user approval.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint) visible in schema. LLMs cannot distinguish safe read-only tools from destructive ones without explicit hints.
Error handling guidance absent. Tools provide no recovery hints (e.g., 'If run_id not found, call begin_run first'). Agents cannot self-correct on failures.