MCP Server for Aiana - exposes memory operations to Claude. Monitors and records conversations in real-time, providing semantic search, memory management, and context injection.
Aiana MCP Server provides 8 tools with consistent naming conventions (verb_noun pattern) and reasonable descriptions. However, critical gaps exist in schema completeness, parameter validation guidance, and output documentation. Most tools lack explicit parameter type information in their descriptions, and output schemas are entirely undocumented. The server relies on semantic memory operations (search, add, recall) which are well-scoped but lack error guidance for recovery scenarios. No tool implements confirmation patterns for destructive operations (memory_add, memory_feedback write operations). Descriptions are adequate (averaging ~130 chars) but fall short of LLM-optimized 50-200 char baseline. Only 4 of 8 tools have complete parameter documentation.
Get Aiana system status and statistics
Save a memory or note for future recall
Provide feedback on recalled memories to improve future retrieval. Call this after using memory_search or memory_recall to rate how helpful the results were.
Recall context for the current project
Search through past conversations and memories semantically
Add a user preference for future context
List recorded conversation sessions
Output schemas completely undocumented. No response field specifications provided for any of the 8 tools. LLMs cannot predict return structure, forcing runtime discovery and increasing hallucination risk.
Parameter descriptions lack format/constraint guidance. 'limit' parameters (session_list, memory_search) have no documented bounds (min/max). 'session_id' (session_show) lacks format guidance despite being 'partial match', what constitutes a valid partial? No regex or length constraints stated.
No error handling guidance for any tool. memory_search may return zero results, but no indication whether to retry, suggest alternatives, or ask user for refinement. memory_add could fail due to storage quota or invalid project name, but no recovery path documented.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | C | 61 | 2026-07-28+ | v2 |
| 2026-03-09 | F | 35 | - | v1 |
Show details of a specific session
Write operations (memory_add, preference_add, memory_feedback) lack confirmation or dry-run patterns. An agent could bulk-add irrelevant memories or corrupt feedback data without guardrails. No idempotency guarantees stated.
aiana_status has empty inputSchema (no properties). Description is vague ('Get Aiana system status and statistics'). What metrics are returned? What does 'status' mean, running, health checks, database connected? Insufficient for tool selection.
Parameter naming inconsistency: memory_search uses 'query', but memory_recall uses 'project' as required parameter. No 'query' equivalent in recall, unclear if recall searches or simply loads all project context. Tool relationship obscured.
memory_feedback references 'memory_id' and 'memory_source' enum (semantic|fulltext|recall) but prior tools (memory_search, memory_recall) don't document whether they return memory_id or how to extract it. Coupling between tools is undocumented.