Local MCP server for the Revember v2 knowledge base. Provides tools for managing topics, concepts, cards, learning sessions, and knowledge validation.
18 tools with mostly complete schemas and descriptions, but significant gaps in parameter documentation and error guidance. Tool names follow verb_noun convention well (create_topic, list_topics, search_knowledge). Descriptions average ~80 chars, below the 194-char baseline for A+ tools. Most parameters have type definitions via Zod, but descriptions are sparse or missing for many fields. Output schemas are not documented. Error handling is minimal, no recovery guidance or actionable error messages visible in tool definitions.
Build a personalized review plan based on learner progress
Capture a learning session with review events
Create Revember topic
Get a brief summary of learner progress across all topics
List all topics in the knowledge base
Patch (partially update) a flashcard
Patch (partially update) a concept
Read a specific topic by ID
Output schemas not documented. LLMs cannot plan downstream calls or extract required fields from responses. No documentation of what fields list_topics, search_knowledge, or get_learner_brief return.
Error handling absent from tool definitions. No recovery guidance, error classification, or actionable messages. Tools like update_topic with expectedRevision conflict detection provide no guidance on what to do if revision mismatch occurs.
Parameter descriptions sparse or missing. Many fields like 'sources' (array), 'relationships' (array), 'checks' (array) lack detail on structure, format, or constraints. LLMs cannot infer what objects these arrays should contain.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 54 | 2026-07-28+ | v2 |
Retire (deactivate) a flashcard
Full-text search across all knowledge base content
Search topics by title or ID
Update the markdown note for a topic with revision metadata
Update topic metadata (title, summary, sources, relationships)
Create or update a flashcard (question) within a topic
Create or update a concept within a topic
Validate the entire knowledge base for consistency and correctness
Validate topic data structure
Validate a specific topic file
No pagination support on list/search tools. list_topics and search_knowledge lack limit, offset, or cursor parameters. Large result sets will blow context windows without pagination.
Tool names 'upsert_concept' and 'upsert_card' combine create+update semantics. Consider splitting into separate create_concept/update_concept and create_card/update_card for clearer agent reasoning and idempotency guarantees.