Vocab Voyage

Returns today's vocabulary Word of the Day. Optionally scoped to a test family (isee, ssat, sat, psat, gre, gmat, lsat, general).

Look up the definition, part of speech, example sentence, and synonyms/antonyms for a vocabulary word.

Generate a multiple-choice vocabulary quiz for a test family (isee, ssat, sat, psat, gre, gmat, lsat, general). Returns 1–10 questions with answers. Renders the Vocab Voyage quiz widget on supporting hosts; per-answer taps inside the widget persist mastery for signed-in users.

Get a sample of vocabulary words from a specific Vocab Voyage course. Use list_courses to discover slugs.

Explain what a word means inside a specific sentence — useful when a word has multiple meanings.

Returns a sample 7-day study plan (5 words/day) for a given test family. Optional target date for context. Renders the Vocab Voyage study-plan widget on supporting hosts; tapping 'Start Day N' launches a flashcard session seeded with that day's words.

Return a small flashcard deck (1–12 cards) for a test family. Renders the Vocab Voyage flashcards widget on supporting hosts; falls back to a markdown list elsewhere. 'I knew it / I didn't' buttons inside the widget persist mastery for signed-in users.

Launch a Vocab Voyage mini-game inside the host chat. Renders the matching ui://vocab-voyage/game/{slug} widget on hosts that support MCP Apps; falls back to a deep link otherwise. Per-question answers persist via record_word_result; round completion fires record_session_complete + award_game_xp so MCP play counts toward streaks, XP, and mastery for signed-in users. Supported slugs: word_match, spelling_bee, speed_round, synonym_showdown, word_scramble, fill_in_blank, context_clues, word_guess, picture_match, crossword, word_search. Use list_courses + a test_family hint for tailored vocab.

Persist a single word answer (correct/incorrect) to the user's mastery progress. Mirrors the web app's word-mastery scaling so MCP study counts toward leaderboards and streaks. Requires sign-in.

Record a completed study session: writes study_sessions, awards study-time XP (+1/min, capped 30/day), and updates the daily streak. Use after a play_game / quiz / flashcard session ends. Requires sign-in.

Award score-based XP from a game/activity (separate from study-time XP). Cascades to the leaderboard via DB trigger. Requires sign-in.

Manually mark a word as mastered for the signed-in user (same as the flashcard 'I knew this' override). Requires sign-in.

Manually mark a word as still-learning for the signed-in user (resets mastery toward learning band). Requires sign-in.

Run the adaptive-mastery promotion logic for the signed-in user (delegates to the web app's update-adaptive-mastery function). Requires sign-in.

Returns Vocab Voyage's lifecycle-aware guidance: the user's current phase (e.g. student.at_risk), a friendly greeting, 2–3 recommended tool calls, and an optional CTA. Renders the session-debrief widget on supporting hosts. Anonymous callers get visitor.* phase suggestions.

Bias subsequent Sparkle guidance toward a persona (student | parent | tutor | explorer). Session-scoped: the host should pass the chosen persona back to get_sparkle_guidance.

One-line 'do this next' hint derived from the user's current lifecycle phase. Useful when the agent wants a quick recommendation without rendering a full guidance card.