MCP Server for ManSit - Exposes LevelDB and File Vault as standardized tools
ManSit MCP server has basic tool definitions with schemas and descriptions present, but falls short of production quality. All 6 tools have descriptions (10-60 chars, below the 194-char baseline) and input schemas with type definitions. However, descriptions are generic and lack actionable context for LLM selection. No output schemas documented. Parameter descriptions are minimal. No error recovery guidance. No tool annotations (readOnlyHint, etc.). Tools are read-only but this is not explicitly declared in descriptions. Missing pagination support despite list_conversations and list_vault_files returning unbounded results. No parameter constraints (enums, ranges, patterns) despite accepting free-form strings.
Get relevant context for a prompt
Retrieve a specific conversation by session ID
List all available conversation sessions
List all files in the File Vault
Read a file from the File Vault
Search through conversation history in LevelDB
Descriptions are too short (10-60 chars vs 194-char baseline) and lack actionable context. 'Search through conversation history in LevelDB' does not explain WHEN to use this vs get_conversation, what format the query accepts, or what the response structure is.
No output schemas documented. LLMs cannot plan downstream calls or extract fields without knowing response structure. All tools return JSON text blobs but structure is not declared.
list_conversations and list_vault_files lack pagination. No offset/cursor parameter, no total_count in response. Unbounded iteration over LevelDB or filesystem risks context window exhaustion and timeout.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 44 | 2026-07-28+ | v2 |
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). All tools are read-only but this is not declared, forcing LLMs to infer safety from descriptions.
Parameter descriptions are minimal or missing context. 'query' in search_memories does not specify format (free text? regex? boolean operators?). 'directory' in list_vault_files lacks default behavior documentation.