learning-tool-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LEARNING_TOOL_DATA_DIR | No | Directory where study material is stored. Defaults to ~/.learning-tool if not set. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ingest_materialA | Ingest a PDF and store its text as study material. Returns document_id, title and concept_count. Call get_material next to read the stored material before generating any flashcards or quiz questions. |
| get_materialA | Return the stored source material (text concepts) of a document. Use this material as the ONLY source when generating flashcards and quiz questions: every item must come from this document's material, never from outside facts or your own knowledge. |
| list_documentsA | List every stored document with its id, title, concept count, flashcard count and quiz count. Call this at the start of a session to discover document ids. |
| get_study_itemsA | Return the flashcards and quiz questions already saved for a document. This returns generated study items; get_material returns the raw source concepts instead. |
| get_due_itemsA | Return the study items due for review now, most overdue first, scheduled with the SM-2 spaced-repetition algorithm. Never-reviewed items are included after the overdue ones. Use this to pick what to study next. In hosts that support MCP Apps, calling this renders the interactive study widget. |
| save_flashcardsB | Save generated flashcards to a document. Each card must have a front and a back. Returns the stored cards with their assigned ids. |
| save_quizA | Save generated quiz questions to a document. Each question needs question, answer and question_type (multiple_choice or short_answer). A multiple_choice question also needs options: at least 2, with the answer exactly one of them. Returns the stored questions with their assigned ids. |
| submit_responseA | Record an answer to a study item. Quiz questions are graded automatically against the stored answer; flashcards are self-reported, so answer must be 'correct' or 'incorrect'. item_type is 'flashcard' or 'quiz'. Optional confidence is 'guessed', 'unsure' or 'confident'. Returns is_correct and the updated progress. |
| get_session_stateA | Return study progress for a document: mastered, to_review, in_progress, remaining and total item counts, plus a confidence breakdown counting each answered item's latest self-reported confidence (guessed, unsure, confident, unreported). |
| export_documentA | Export a document's flashcards and quiz questions to an Anki-importable CSV file on this machine. Writes the file and returns its path; it does not return the CSV text. Defaults to /exports/document--anki.csv, or pass output_path to choose the location. Set include_quiz false to export only flashcards. |
| delete_documentA | DESTRUCTIVE and irreversible: permanently deletes a document along with its material, flashcards, quiz questions and all answer history. Confirm with the user by name (state the document's title) before calling this tool. |
| reset_progressA | DESTRUCTIVE and irreversible: erases a document's entire answer history, discarding mastery progress and review schedules. Flashcards and quiz questions are kept. Confirm with the user before calling this tool. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| study_widget | Interactive study-session widget (flashcards, quizzes, progress) |
TDQS
Scored across 12 tools
Each tool targets a distinct resource or lifecycle stage: ingestion vs retrieval, saving flashcards vs quizzes, review scheduling vs progress reporting. The few pairs that could overlap (get_study_items/get_material, get_due_items/get_session_state) are explicitly differentiated in their descriptions.
All tools use a consistent imperative verb + noun snake_case pattern (save_, get_, ingest_, list_, submit_, export_, delete_, reset_). The style is uniform, making the action and target predictable across the entire set.
12 tools is well within the ideal range and each serves a distinct function in the study workflow: ingest, generate/save, retrieve, review, track, export, and manage documents. No tool feels redundant or ornamental.
The core learning loop is covered end-to-end: ingest material, save generated items, retrieve due items, log responses, and monitor progress. Minor gaps exist—there is no way to edit or delete individual flashcards/quiz questions without deleting the whole document—but these are workable and don't block the main workflow.