MCP server for SurrealDB-based knowledge base with vector/graph/document database capabilities
Single tool 'reindex' has a clear, action-oriented name and a substantive description (145 chars) explaining what it does and its recovery mechanism. However, the input schema is minimal (only 'dry_run' boolean with basic description), and critically, there is NO documented output schema visible in the source. The tool performs a significant write operation but lacks error handling guidance, recovery instructions, or structured output documentation. No tool annotations (destructiveHint, idempotentHint) are present. The server exposes only one tool with limited parameter depth, making it difficult to assess broader composition patterns.
Rebuild every document's chunks and graph mentions. Handles model/dimension changes with atomic transactions and interruption recovery via reindex_in_progress marker.
No output schema documented. Tool returns unstructured result; LLM cannot plan downstream actions or extract structured data.
No error handling guidance. Tool performs destructive write (reindex) but provides no recovery instructions, retryability classification, or actionable error messages.
Missing tool annotations. Destructive operation (reindex) lacks destructiveHint annotation to signal to LLM that this modifies state.
No confirmation/dry-run pattern documented. Tool accepts dry_run parameter but description does not explain how to use it or what the dry-run response contains.
Minimal parameter depth. Only one input parameter (dry_run); no granularity for selective reindexing, progress reporting, or scope control.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 61 | 2026-07-28+ | v2 |