Personal knowledge system - MCP server with PostgreSQL backend for storing, searching, and managing knowledge cells with support for attachments, embeddings, and multi-user access control
Critical failures across naming, descriptions, and schemas. 53 tools defined but most lack actionable descriptions and complete input schemas. Tool names are inconsistent (verb_noun vs bare nouns: 'status' vs 'search', 'wake_up' vs 'health'). Most parameter descriptions are generic ('Optional realm filter' repeated 20+ times). Input schemas for ~30 tools are empty objects {} with no parameters defined. No output schemas documented. Error handling absent. This server fails to meet baseline production standards for agent tool definition.
Store a new knowledge cell
Add a reference
Add a tunnel connection
Approve pending items
Access archivist log
List missing blueprints
Access consumption queue
30 of 53 tools have empty input schemas ({}). Cannot validate LLM-provided parameters or guide tool selection.
Most tool descriptions are under 20 characters or generic ('Optional realm filter' repeated 20+ times). LLMs cannot determine when to select tools without actionable descriptions.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 34 | 2026-07-28+ | v2 |
Retry consumption
Find contradictions in the knowledge base
Generate data quality report
Read diary entries
Write a diary entry
Get overview of an entity
Count facets with optional filtering
Get information about an attachment
Retrieve a blueprint definition
Retrieve a specific knowledge cell
Check system health
Retrieve historical information
Add to knowledge graph
Create an alias in the knowledge graph
Invalidate knowledge graph entries
Rename a knowledge graph predicate
Link a reference
List knowledge cells with optional filtering
List registered agents
List attachments
List cell IDs with optional filtering
List documents
List media files
Manage tags
List pending approvals
Get predicate cardinality information
Get details of a queen run
List queen runs
Retrieve reading list
Reclassify a knowledge cell
Register a new agent
Reject a knowledge cell
Remove a tunnel connection
Resolve a contradiction
Revise an existing knowledge cell
Revise a fact in the knowledge graph
Manage saved searches
Search the knowledge base
Search the knowledge graph
Report system status and health
Query historical versions of knowledge cells
Traverse the knowledge graph structure
Update a blueprint definition
Update identity information
Upload an attachment
Wake up the system or refresh state
No output schemas documented for any tool. LLMs cannot plan downstream calls or extract required fields. Violates pattern:tool requirement for documented return types.
Inconsistent naming conventions. Generic names ('status', 'health', 'list', 'history') lack action verbs and conflict with common patterns. 'list' alone is ambiguous, should be 'list_cells' or 'list_knowledge_items'. Violates verb_noun pattern.
No error handling guidance. Tools lack recovery hints, retryability classification, or actionable error messages. Agents cannot self-correct on failures.