Vocab Voyage MCP Server

The official public mirror of the Vocab Voyage Model Context Protocol server — 20 tools + 17 interactive widgets for vocabulary learning and standardized test prep (ISEE, SSAT, SAT, PSAT, GRE, GMAT, LSAT).

• 20 MCP tools (including flashcards, 11 mini-games, progress tracking, and Sparkle coaching)

• 17 interactive widgets (quiz, flashcards, study plan, progress dashboard, session debrief, and more)

• Hosted — no install required

• Optional personal tokens for personalized features

• 🔗 Server URL: https://gponcrussdahcdyrlhcr.supabase.co/functions/v1/mcp-server

• 📚 Browse tools: https://vocab.voyage/mcp/tools

• 🛠 Auth & scopes: https://vocab.voyage/developers/auth

• 🪪 License: MIT

Install

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "vocab-voyage": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://gponcrussdahcdyrlhcr.supabase.co/functions/v1/mcp-server"]
    }
  }
}

ChatGPT Apps SDK / Cursor / Cline

Add a custom remote MCP server with the URL above and (optionally) a Bearer vv_mcp_… token generated from https://vocab.voyage/developers/auth.

OpenClaw

openclaw skills install vocab-voyage

Tools

Tool count: 20.

• get_word_of_the_day — Returns today's vocabulary Word of the Day, optionally scoped to a test family.
• get_definition (widget-aware) — Look up the definition, part of speech, example sentence, and synonyms/antonyms for a word.
• generate_quiz (widget-aware) — Generate a multiple-choice vocabulary quiz for a test family (1–10 questions).
• get_course_word_list — Get a sample of vocabulary words from a specific Vocab Voyage course.
• list_courses — Lists all 13 Vocab Voyage courses with their slugs and descriptions.
• explain_word_in_context — Explain what a word means inside a specific sentence.
• study_plan_preview (widget-aware) — Returns a sample 7-day study plan (5 words/day) for a given test family.
• get_flashcards (widget-aware) — Returns a tap-to-flip flashcard deck. Per-card answers persist via record_word_result.
• get_my_progress (widget-aware) — Auth-only personal dashboard: streak, XP, mastery split, next-up words, recent misses.
• play_game — Launches one of 11 vocabulary mini-games (word_match, spelling_bee, speed_round, synonym_showdown, word_scramble, fill_in_blank, context_clues, word_guess, picture_match, crossword, word_search). Per-answer events flow to record_word_result; round XP via award_game_xp.
• get_sparkle_guidance (widget-aware) — Lifecycle-aware coaching: returns a phase-appropriate greeting (16 phases) and a recommended next tool/action. Renders the session-debrief widget when relevant.
• set_persona — Switch agent bias between student, parent, tutor, or explorer.
• get_recommended_next_action — Returns a one-line recommendation for what the user should do next.
• list_starter_prompts — Lists the 6 MCP prompts (vocab_kickoff, test_prep_quiz, session_debrief, …) for hosts that don't surface prompts/list.
• record_word_result — Auth: log a per-card answer (correct or incorrect).
• record_session_complete — Auth: log session totals and award XP.
• award_game_xp — Auth: grant bonus XP from a completed mini-game round.
• mark_word_known — Auth: add a word to the user's queue or mastered list.
• mark_word_difficult — Auth: flag a word as needing more review.
• update_adaptive_level — Auth: adjust the user's adaptive difficulty floor/ceiling.

Widgets

Widget count: 17.

• ui://vocab-voyage/word-of-the-day — Word of the Day (learn, 560x360) via get_word_of_the_day
• ui://vocab-voyage/flashcards — Flashcards (learn, 560x460) via get_flashcards
• ui://vocab-voyage/quiz — Quiz (learn, 560x520) via generate_quiz
• ui://vocab-voyage/study-plan — Study Plan (learn, 6

... View full README on GitHub