MCP server for storing and retrieving information with embeddings
Two tools with basic schemas and descriptions, but significant gaps in parameter documentation and output schema clarity. save-memory has 5 parameters with descriptions; search-memory has 2. Both tools lack documented return schemas, making it unclear what fields agents should expect. Descriptions are present but generic (10-50 chars baseline). No error recovery guidance. No tool annotations (readOnlyHint/destructiveHint). Prompts are defined but add minimal value, they simply restate tool names. Overall structure is functional but falls short of production quality.
Save content to vector database
Search for information in vector database
No documented output schemas. Tools return text responses but agents cannot predict field structure or chain results to downstream tools.
Missing tool annotations. save-memory is destructive (WRITE risk) but lacks destructiveHint. search-memory is read-only but lacks readOnlyHint. LLMs cannot infer safety properties.
Error handling lacks recovery guidance. Both tools return generic error messages ('Error storing content', 'Error searching content') without actionable next steps for the agent.
Descriptions are too short (10-50 chars). 'Save content to vector database' and 'Search for information in vector database' lack context on WHEN to use each tool or what prerequisites exist.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 56 | 2026-07-28+ | v2 |
Optional parameters lack clear defaults. 'type' defaults to 'markdown', 'source' to 'api', 'parentPath' to undefined, but the tool description does not state these defaults, forcing agents to guess.