Loading ToolBench

Reading the current corpus…

mnemex MCP server · D · ToolBench

mnemex

Anchored memory for AI coding agents — MCP server that binds decisions to code symbols and delivers context just-in-time

2026-07-28+STDIO9 tools

58/100

Definition Quality74

Protocol Readiness50

Supportability38

Spec posture

Inferred effective spec 2026-07-28+·current baseline 2026-07-28

Static source inference · medium confidence

Current-spec patterns detected

Summary

Mnemex defines 9 tools with complete input schemas and descriptions. Naming follows verb_noun convention (remember_, recall_, forget_, check_, override_, reconcile_, export_, import_). Descriptions are substantive (80-180 chars), explaining WHAT and WHEN. However, parameter descriptions lack actionable constraints (no enums, ranges, or format specs). Output schemas are undocumented, LLMs cannot predict response structure. Error handling is minimal; tools return generic error dicts without recovery guidance. No tool annotations (readOnlyHint, destructiveHint) despite clear risk profiles (WRITE, DESTRUCTIVE, READ_ONLY). Composition is sound: tools are single-purpose and chainable via memory_id references.

Tools (9)

check_memory_freshnessread onlysource verified75/100

Check whether anchored memories are fresh, stale, or orphaned.

check_proposed_changeread onlysource verified73/100

Check a proposed edit against fresh anchored decisions. A change blocks only on a fresh, confidence-qualified semantic contradiction. Local mode and every other result are advisory.

export_brainwritesource verified72/100

Export selected local decision records as a portable bundle.

forget_memorydestructivesource verified75/100

Remove a memory by its ID.

import_brainwritesource verified72/100

Import a project-brain bundle into the local database.

override_decision_guardwritesource verified73/100

Record an explicit override for a prior guard result.

recall_memoriesread onlysource verified77/100

Retrieve relevant memories via hybrid BM25+vector search.

Issues (5)

HIGHtool ↗

No output schemas documented. LLMs cannot predict response structure (fields, types, pagination). Tools return dicts with 'memory_id', 'status', 'error' but no formal schema.

remember_decisionrecall_memoriesforget_memorycheck_memory_freshnesscheck_proposed_changeoverride_decision_guardreconcile_stale_decisionexport_brainimport_brain

HIGHconstrained-input ↗

Parameter descriptions lack actionable constraints. 'scope' accepts 'comma-separated scopes' but no enum or examples. 'limit' has no min/max bounds. 'max_tokens' capped at 800 in code but not documented in schema.

recall_memoriescheck_memory_freshnesscheck_proposed_change

MEDIUMtool-annotations ↗

No tool annotations (readOnlyHint, destructiveHint, idempotentHint). Tools marked WRITE/DESTRUCTIVE/READ_ONLY in metadata but not exposed to LLM via schema annotations.

remember_decisionforget_memory

Recommendations

Add formal output schemas to all tools. Document fields, types, and pagination. E.g., recall_memories returns {memories: [{id, content, scope, tags, freshness_status}], total_count, next_cursor}.
Add enums and bounds to parameters. E.g., scope: enum=['project-shared', 'team', 'personal']; limit: integer, minimum=1, maximum=100; max_tokens: integer, minimum=1, maximum=800.
Implement tool annotations in FastMCP. Use @self.mcp.tool(readOnlyHint=True) for recall_memories, check_memory_freshness, check_proposed_change. Use destructiveHint=True for forget_memory, export_brain, import_brain.
Enhance error responses with recovery guidance. E.g., 'AnchorNotFoundError: Symbol "process_payment" not found in src/payments.py. Call check_memory_freshness to verify anchors are fresh, or use remember_decision with a valid symbol.'
Document parameter constraints in descriptions. E.g., 'anchor_node_id: Direct node ID for the anchor (optional, format: alphanumeric + underscore, max 128 chars). Omit if using anchor_file + anchor_symbol.'

Score history

Overall score trend

First recorded score · v2 rubric

58/100

Scored	Grade	Overall	Spec posture	Rubric
2026-09-23	D	58	2026-07-28+	v2