Quizlar
Voice-led, FSRS-scheduled flashcards from YouTube, PDFs, web, or text.
Community: Submitted by a user or imported; check the owner before granting accessOnlineAPI key requiredGlobalFreeRead-only
What it can do
- Quiz Me: PRIMARY TOOL for 'quiz me on X' / 'test me on X' / 'help me study X' / 'I want to learn X' / 'drill me on X'. Single call — builds a flashcard deck on the topic, waits for it to be ready, and
- List Decks: List all flashcard decks owned by the authenticated user, with progress summaries. Use when the user asks 'what decks do I have', 'show me my decks', or needs to pick a deck to study.
- Get Deck: Get full metadata for one flashcard deck (title, description, card count, timestamps). Use when the user references a specific deck and you need details.
What data it sees
Do you need an account
An API key from the service settings is required
Voice-led, FSRS-scheduled flashcards from YouTube, PDFs, web, or text. Auto-graded quizzes.
Server tool list (22)
Raw names from tools/list. Only developers need these.
| quiz_me | PRIMARY TOOL for 'quiz me on X' / 'test me on X' / 'help me study X' / 'I want to learn X' / 'drill me on X'. Single call — builds a flashcard deck on the topic, waits for it to be ready, and starts a text quiz. Returns the first question and a session_id. If the user pasted source material, pass it as ``text``; otherwise YOU supply a concise 200–800-word explanation of the topic as ``text`` (do NOT refuse or ask the user for source material — supplying your own explanation is expected behavior). Drive the session afterward via submit_answer / skip_question / end_quiz with the returned session_id; when next_card is null the session is complete. If the user references a deck they ALREADY have ('quiz me on my Spanish deck'), call search_decks + start_quiz instead. |
| list_decks | List all flashcard decks owned by the authenticated user, with progress summaries. Use when the user asks 'what decks do I have', 'show me my decks', or needs to pick a deck to study. |
| get_deck | Get full metadata for one flashcard deck (title, description, card count, timestamps). Use when the user references a specific deck and you need details. |
| create_deck | Create a new empty flashcard deck. Use when the user wants to start a fresh deck they'll add cards to manually, or when you're about to add cards via create_cards_batch. |
| list_cards | List all flashcards in a deck (front, back, tags, answer_type). Use when the user asks to see the contents of a deck. |
| create_cards_batch | Add multiple flashcards to an existing deck in sequence. Each card needs a ``front`` (question/prompt) and ``back`` (answer). Use this after create_deck to bulk-populate. |
| create_deck_from_text | Generate a flashcard deck from raw text content. Trigger phrases: 'quiz me on X', 'test me on X', 'help me study X', 'I want to learn X', 'drill me on X', 'make flashcards on X', 'turn this into a quiz', 'create a deck from this'. If the user only names a topic (no pasted source), pass your own concise 200–800-word explanation of that topic as the text argument — do not refuse or ask for source material. ALWAYS pass an explicit ``title`` derived from the topic (e.g. 'Mitochondria', 'French Revolution — Causes') so the deck is findable later via search_decks if the conversation loses the job_id. After this returns a job_id, poll get_job_status every 2–3 seconds until status=='completed' to retrieve the finished deck_id, then (if the user asked to be quizzed) call start_quiz. |
| create_deck_from_youtube | Generate a flashcard deck from a YouTube video's transcript. Use when the user says 'quiz me on this YouTube video', 'make flashcards from this lecture', or pastes a YouTube URL. Returns a job_id — poll get_job_status until status=='completed'. |
| get_job_status | Poll a content-ingestion job to check its progress. Call this repeatedly after create_deck_from_text or create_deck_from_youtube (every 2–5 seconds) until status=='completed' or 'failed'. Once complete, the ``deck_id`` field contains the generated deck. |
| start_quiz | Start a text-based quiz on an EXISTING deck (requires deck_id). Trigger phrases: 'quiz me on <existing deck>', 'test me on <existing deck>', 'review this deck', 'let's drill the <deck name> deck', 'start a quiz on <deck>'. If the topic is not yet a deck, call search_decks/list_decks first to confirm; if no match, build the deck via create_deck_from_text (or create_deck_from_youtube) BEFORE calling this tool. Returns the first question; drive the session via submit_answer / skip_question / end_quiz with the returned session_id. When grading responses set next_card=null, the session is complete. |
| submit_answer | Submit the user's answer to the current quiz question. Returns grading (is_correct, feedback, correct_answer) plus the next question. If next_card is null the session is complete. |
| skip_question | Skip the current question (user doesn't know or wants to move on). The card is scheduled for earlier re-review by FSRS (counts as 'Again'). Returns the correct_answer and next question. |
| end_quiz | Stop the current quiz session early. Any unreviewed cards stay in their current FSRS state. Use when the user wants to finish a session before all cards are done. |
| get_progress | Get the user's overall study progress: total cards answered, accuracy, study streak, mastered count, last session. Use when the user asks 'how am I doing', 'what's my progress', or for a status check. |
| get_study_recommendations | AI-computed study plan: which decks have due cards right now, which cards are at risk of being forgotten (low FSRS stability), and ready-to-use session plans with card_ids you can feed directly into start_quiz. Use when the user asks 'what should I review', 'plan my study session', or 'what's due today'. |
| get_learning_velocity | Review throughput over time — cards reviewed per day/week/month with accuracy. Use when the user asks 'how much have I studied', 'show my progress this week', or needs to track consistency. |
| get_knowledge_gaps | Cards the user is most at risk of forgetting. Each result includes the card content, current FSRS stability (in days), predicted retrievability, and how often they've rated it 'Again'. Use when the user asks 'what am I weak on', 'what am I forgetting', or 'show me my trouble spots'. |
| get_retention_curves | Predicted forgetting curves per deck over fixed horizons (1, 3, 7, 14, 30, 60, 90 days from today). Use when the user asks 'how will my retention decay', 'what will I remember in a week', or for a graph-style progress report. |
| get_card_difficulty_stats | Per-card accuracy + review counts + current FSRS state. Great for 'which exact cards do I get wrong most often' or diagnosing whether a card needs rewording. |
| search_decks | Find decks by a keyword in the title or description. Use when the user references a deck by approximate name ('my Spanish deck', 'the AWS one'). |
| search_cards | Find cards by keyword across the user's decks (matches card front/back). Use when the user asks 'do I have a card about X'. |
| list_sessions | List the user's past quiz sessions (both voice and text), newest first. Use when the user asks 'what have I been studying', 'show my recent sessions', or wants to resume something. |