Vocab Voyage
io.github.jaideepdhanoa/vocab-voyage20 MCP tools + 17 widgets for SAT/ISEE/SSAT/GRE/GMAT/LSAT prep. Flashcards, quizzes & games. Hosted.
Tools · 31
Use this when the user asks for today's word, a daily vocabulary nudge, or a single-word warmup. Returns today's deterministic Word of the Day (definition, part of speech, example, synonyms/antonyms),…
Use this when the user asks what a specific word means, requests its definition, part of speech, synonyms/antonyms, or an example sentence. Returns curated dictionary data from the Vocab Voyage corpus…
Use this when the user wants to practice, be quizzed, or test their knowledge across multiple words at once. Generates a 1–10 question multiple-choice quiz for a test family (isee, ssat, sat, psat, gr…
Get a sample of vocabulary words from a specific Vocab Voyage course. Use list_courses to discover slugs.
Lists all 13 Vocab Voyage courses with their slugs and descriptions.
Explain what a word means inside a specific sentence — useful when a word has multiple meanings.
Use this when the user asks for a study plan, a multi-day prep schedule, or how to prepare for a test by date. Returns a 7-day plan (5 words/day) for a given test family. Renders the interactive Vocab…
Use this when the user asks for flashcards, wants to drill words individually, or wants a tap-to-flip review session. Returns 1–12 cards for a test family. Renders the interactive Vocab Voyage flashca…
Use this when the signed-in user asks about their own streak, XP, words mastered, recent activity, or 'how am I doing'. Auth-only personal dashboard. Renders the interactive Vocab Voyage progress widg…
Use this when the user wants to play a vocabulary game, asks for something fun, or wants to learn through play. Launches one of 11 mini-games inside the host chat. Renders the matching ui://vocab-voya…
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 sig…
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.
File a real human-followup support ticket on behalf of the signed-in user. Use this when the user reports a bug, account lockout, complaint about a tutor, or anything Sparkle/the agent cannot resolve …
Use this when the signed-in user asks about words they've gotten wrong, missed words, words to review, or wants to revisit recent mistakes. Returns up to 25 words from the last N days (default 7) with…
Use this when the signed-in user asks 'what did I miss in [that session]', 'which words tripped me up', or 'what was my accuracy on session X'. Pass a session_id (study_sessions.id or adaptive_session…
Use this when the signed-in user asks about pending parent invites, share codes, or whether their parent invite has been accepted yet. Returns each pending invite with hours_until_expiry. RULE: if any…
Parent-only. Sends a 'check-in' push notification (and email fallback) to a linked child. Use when the parent says things like 'remind my kid to study', 'nudge my child', 'tell Sam to do their words t…
Resend a pending parent invite by id. Use after get_pending_invites surfaces an invite expiring in <24h, or when the user explicitly asks to resend. Re-emails the existing invite_token; no new code is…
Use this when a signed-in student asks how they're doing in their tutor class, who's ahead, who their rival is, or who they should challenge. Auth-only. Returns weekly XP rank inside the user's tutor …
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 widg…
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.
Lists Vocab Voyage's MCP starter prompts (also exposed via the standard MCP prompts/list endpoint). Useful for hosts that don't yet support prompts/list.
Auth-only. Personal study trends over a window (default 14 days, max 90): session count, total minutes, accuracy trend (up/down/flat), and top-missed words. Use after a user asks 'how am I trending / …
Auth-only. Tutor-only. Aggregate class-level trends across the tutor's classes (default 14 days, max 30). Pass `class_id` to scope to one class; omit it to get a worst-first rollup across up to 25 cla…
Auth-only. Parent-only. Detailed breakdown for a single child's study/quiz session — accuracy, missed words, duration. Defaults to the most recent session for the parent's first linked child if no `ch…
Auth-only. Returns a personalized N-day study plan (default 7, range 3–7) chosen from one of four focus modes (weak-topic-drill / streak-recovery / new-words / review-mastery) based on the user's rece…
Resources · 18
Hero card with today's vocab word, definition, audio button, and add-to-queue CTA.
ui://vocab-voyage/word-of-the-day
Tap-to-flip flashcard deck. 'I knew this' / 'I didn't' buttons persist mastery via the same tables as the web app.
ui://vocab-voyage/flashcards
Interactive multiple-choice quiz. Per-answer events flow to record_word_result; session totals to record_session_complete.
ui://vocab-voyage/quiz
Seven-day expandable plan grid. 'Start Day N' launches a flashcard session seeded with that day's words.
ui://vocab-voyage/study-plan
Auth-only dashboard with streak, XP, mastery split, next-up words, and recent misses.
ui://vocab-voyage/progress
Tap the word, then tap its definition. Each correct pair persists mastery; round totals award XP and update streaks.
ui://vocab-voyage/game/word_match
Read the definition (and hear the word) — type the spelling. Per-word answers persist via record_word_result.
ui://vocab-voyage/game/spelling_bee
60-second sprint. Pick the right meaning before time runs out; streaks earn bonus XP.
ui://vocab-voyage/game/speed_round
Pick the closest synonym for each word. Correct picks award XP and update mastery.
ui://vocab-voyage/game/synonym_showdown
Unscramble the letters to spell each vocab word. Per-answer results persist; round XP awards via award_game_xp.
ui://vocab-voyage/game/word_scramble
Pick the word that completes each sentence. Tap-to-answer; mastery persists per-question.
ui://vocab-voyage/game/fill_in_blank
Infer each word's meaning from its surrounding sentence. Correct picks award XP and update mastery.
ui://vocab-voyage/game/context_clues
Hangman-style letter guessing for vocab words. Wins/losses persist via record_word_result.
ui://vocab-voyage/game/word_guess
Match each word to its emoji-cued image. Round XP awards via award_game_xp.
ui://vocab-voyage/game/picture_match
Mini vocabulary crossword. Solving each clue persists mastery and awards XP at completion.
ui://vocab-voyage/game/crossword
Find hidden vocab words in a letter grid. Each find persists mastery; round XP awards via award_game_xp.
ui://vocab-voyage/game/word_search
Post-session summary with weak words, next-up queue, and Sparkle's recommended next action.
ui://vocab-voyage/session-debrief
Weekly class leaderboard with the user's rank, XP, top 3 (leader anonymised when not #1), and a winnable rival 1v1 challenge CTA.
ui://vocab-voyage/class-standing
Prompts · 6
Start a Vocab Voyage session: today's word + a quick activity recommendation.
Drill me with a quick quiz for a specific test family (SAT, ISEE, GRE, etc.).
Run a short flashcard study session and persist the results.
Read my Vocab Voyage progress: streak, XP, mastery split, next-up words.
Pick the right Vocab Voyage mini-game for the moment and launch it.
After a quiz or game, surface what I missed and what to study next.
Similar MCP servers embedding-nearest
How to use
Add to your Claude Desktop / Cursor / Cline MCP config:
{
"mcpServers": {
"vocab_voyage": {
"url": "https://gponcrussdahcdyrlhcr.supabase.co/functions/v1/mcp-server?ref=mcp_registry",
"transport": "streamable-http"
}
}
}