A self-contained, spec-compliant ALEPH node for autonomous memory management and knowledge distribution. Provides endpoints for depositing, searching, and managing knowledge chunks with peer discovery and agent standing.
Server has 19 tools with complete input schemas and descriptions. Naming follows verb_noun convention (deposit_memory, search_memories, retrieve_chunk). However, descriptions are terse (10-50 chars for most tools), parameter descriptions lack detail on constraints and formats, and output schemas are not documented. Error handling is minimal. Security concerns: API key passed via X-API-Key header (acceptable) but no per-tool permission documentation. Composition is reasonable, tools are single-purpose, but many lack the LLM-optimized descriptions (50-200 chars) and constraint details needed for reliable agent invocation.
Discovery manifest endpoint at /.well-known/agent-library.json
Retrieve agent reputation and standing tier (public)
Retrieve version chain for a chunk (public)
Alias for /memories/{chunk_id} (v1 frontend / MCP compatibility)
Create API key (admin only)
Deposit a knowledge chunk (requires X-API-Key)
Alias for /memories (v1 frontend / MCP compatibility, requires X-API-Key)
Get caller API key information
Descriptions are too terse (10-50 chars for most tools). Rubric baseline is 194 chars average; LLM-optimized descriptions should be 50-200 chars. Current descriptions lack context on WHEN to use each tool and what it returns.
Output schemas are not documented. Tools return JSON but LLMs cannot infer response structure. Rubric requires documented return types for 100% of A+ tools. Add response examples or schema definitions to tool descriptions.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 50 | 2026-07-28+ | v2 |
Liveness check endpoint
List known peer nodes (public)
Log a knowledge conflict between two chunks
Alias for /peers (v1 frontend / MCP compatibility)
Alias for /memories/search (v1 frontend / MCP compatibility)
Register a peer node
Retrieve a specific chunk by ID (public)
Revoke API key (admin only)
Search knowledge chunks (public)
Search peer nodes by capabilities (public)
Live network topology for canvas UI (v1 frontend / MCP compatibility)
Parameter descriptions lack constraint details. Rubric requires format, range, and allowed values in descriptions. E.g., 'limit' params have min/max in schema but descriptions don't explain the constraint. 'agent_id' lacks format guidance (UUID? alphanumeric?).
V1 alias tools (query_v1_alias, deposit_v1_alias, peers_v1_alias, chunk_v1_alias, topology_v1_alias) have poor naming. Names do not clearly indicate they are aliases or deprecated. Rubric: tool names must convey intent clearly. Consider renaming to 'query_memories_v1', 'deposit_memory_v1', etc., or removing if not needed.
No error handling guidance. Tools lack descriptions of failure modes and recovery steps. Rubric requires: 'Error responses must tell the LLM what to do next.' E.g., if chunk_id not found, should agent retry, search for alternatives, or fail? No guidance provided.