MCP server for persistent AI memory and consciousness
This server demonstrates solid foundational quality with well-structured tool definitions, complete JSON schemas, and clear parameter documentation. All 20 tools have names following verb_noun convention and descriptions explaining their purpose. However, there are notable gaps: output schemas are not documented (agents cannot see what fields are returned), descriptions lack depth about when/why to call tools, and several parameter descriptions are minimal. Error handling patterns and recovery guidance are absent from the code visible. The domain (memory/consciousness) is specialized but the tool interface is well-typed. Average per-tool score is 62/100.
Activate a memory cluster and get its associated memories
Archive old memories based on age and importance criteria
Consolidate multiple working memories into a single semantic memory
Create a new memory with optional type-specific metadata
Create a new memory cluster
Create a relationship between two memories
Create a temporary working memory with expiration
Output schemas are completely undocumented. Agents cannot see what fields each tool returns, preventing downstream chaining and forcing LLMs to guess output structure.
Destructive tools (prune_memories) lack confirmation patterns. No dry-run or explicit user confirmation before permanent deletion, risking catastrophic mistakes.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | C | 66 | 2026-07-28+ | v2 |
| 2026-03-09 | F | 46 | - | v1 |
Find memories related through graph traversal
Find clusters similar to a given cluster
Get recently activated memory themes and patterns
Get detailed analytics for a memory cluster
Retrieve the current identity model and core memory clusters
Retrieve a specific memory by ID and mark it as accessed
Retrieve memory clusters ordered by importance/activity
Get overall statistics about memory system health
Get relationships for a specific memory
Retrieve current worldview primitives and beliefs
Permanently delete memories based on criteria
Search memories by vector similarity
Search memories by text content using full-text search
Tool descriptions are too brief and lack context. Many (get_identity_core, get_worldview, get_memory_health) are under 60 characters and do not explain when/why to call them or what they return.
No error handling or recovery guidance visible in source. No examples of actionable error messages like 'Memory not found. Try search_memories_text()' or validation hints.
Parameter descriptions lack constraint clarity. For example, 'importance' is described as '0.0 to 1.0' but no validation rules shown; 'threshold' and 'min_strength' lack guidance on valid ranges.
consolidate_working_memory requires clients to compute embeddings externally. No guidance on embedding provider, dimension, or format, forces agent to guess.
No pagination support visible in list-like tools (get_memory_clusters returns arbitrary limit=20 but no cursor/offset for large result sets).
Tool composition risk: multiple tools operate on embeddings but no tool exists to generate embeddings from text. Agents cannot fulfill 'create_memory' without external embedding service.