MCP server for Evidence Decision Trace — anchors claims and decisions to verifiable sources, fails CI when anchors go stale
Claims-Ledger provides 5 domain-specific tools with clear, detailed descriptions (avg 150 chars) and well-structured input schemas. Tool names follow verb_noun convention (ledger_search, trace_add_decision, anchor_verify). Schemas include proper types, enums, and constraints. However, output schemas are not documented in the visible code, and error handling guidance is minimal. The domain is specialized (source-anchored claims verification) but lacks recovery hints for common failure modes.
Freshness-check a single anchor ref (optionally with its quote) against the working tree.
List existing claims (optionally filtered by scope or path substring) so an agent knows which claims its diff might invalidate.
Keyword search over the repo's Claims Ledger and the open trace — find anchored evidence BEFORE deciding.
Append an anchored decision to the open trace. Each anchor's quote MUST literally resolve at its ref — fabricated quotes are rejected.
Run the cross-family judge panel over every decision⟷evidence pair in the open trace (median + spread>20 flagging). Skips gracefully without OPENROUTER_API_KEY.
Output schemas not documented. LLMs cannot infer what ledger_search, trace_score, or anchor_verify return, forcing them to guess field names and types for downstream reasoning.
trace_score has empty input schema ({}). No parameters documented. Description mentions OPENROUTER_API_KEY but does not explain how to provide it or what happens if missing.
Error handling lacks recovery guidance. No tool description explains what to do if an anchor quote fails to resolve, if the ledger is malformed, or if the OpenRouter API is unavailable.
ledger_search and ledger_claims lack pagination guidance. No mention of result limits, total counts, or how to handle large ledgers. Default k=5 is reasonable but undocumented.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 54 | 2026-07-28+ | v2 |
trace_add_decision requires 'anchors' array with minItems=1 but does not explain what happens if a quote fails to resolve at its ref. Validation error messages are not documented.