{
  "markdown": "# Vocab Voyage MCP Server\n\nThe official public mirror of the [Vocab Voyage](https://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).\n\n- 20 MCP tools (including flashcards, 11 mini-games, progress tracking, and Sparkle coaching)\n- 17 interactive widgets (quiz, flashcards, study plan, progress dashboard, session debrief, and more)\n- Hosted — no install required\n- Optional personal tokens for personalized features\n\n- 🔗 Server URL: `https://gponcrussdahcdyrlhcr.supabase.co/functions/v1/mcp-server`\n- 📚 Browse tools: <https://vocab.voyage/mcp/tools>\n- 🛠 Auth & scopes: <https://vocab.voyage/developers/auth>\n- 🪪 License: MIT\n\n## Install\n\n### Claude Desktop\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"vocab-voyage\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"https://gponcrussdahcdyrlhcr.supabase.co/functions/v1/mcp-server\"]\n    }\n  }\n}\n```\n\n### ChatGPT Apps SDK / Cursor / Cline\n\nAdd a custom remote MCP server with the URL above and (optionally) a\n`Bearer vv_mcp_…` token generated from\n<https://vocab.voyage/developers/auth>.\n\n### OpenClaw\n\n```bash\nopenclaw skills install vocab-voyage\n```\n\n## Tools\n\n<!-- mcp:tools:start -->\nTool count: 20.\n\n- `get_word_of_the_day` — Returns today's vocabulary Word of the Day, optionally scoped to a test family.\n- `get_definition` (widget-aware) — Look up the definition, part of speech, example sentence, and synonyms/antonyms for a word.\n- `generate_quiz` (widget-aware) — Generate a multiple-choice vocabulary quiz for a test family (1–10 questions).\n- `get_course_word_list` — Get a sample of vocabulary words from a specific Vocab Voyage course.\n- `list_courses` — Lists all 13 Vocab Voyage courses with their slugs and descriptions.\n- `explain_word_in_context` — Explain what a word means inside a specific sentence.\n- `study_plan_preview` (widget-aware) — Returns a sample 7-day study plan (5 words/day) for a given test family.\n- `get_flashcards` (widget-aware) — Returns a tap-to-flip flashcard deck. Per-card answers persist via record_word_result.\n- `get_my_progress` (widget-aware) — Auth-only personal dashboard: streak, XP, mastery split, next-up words, recent misses.\n- `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.\n- `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.\n- `set_persona` — Switch agent bias between student, parent, tutor, or explorer.\n- `get_recommended_next_action` — Returns a one-line recommendation for what the user should do next.\n- `list_starter_prompts` — Lists the 6 MCP prompts (vocab_kickoff, test_prep_quiz, session_debrief, …) for hosts that don't surface prompts/list.\n- `record_word_result` — Auth: log a per-card answer (correct or incorrect).\n- `record_session_complete` — Auth: log session totals and award XP.\n- `award_game_xp` — Auth: grant bonus XP from a completed mini-game round.\n- `mark_word_known` — Auth: add a word to the user's queue or mastered list.\n- `mark_word_difficult` — Auth: flag a word as needing more review.\n- `update_adaptive_level` — Auth: adjust the user's adaptive difficulty floor/ceiling.\n<!-- mcp:tools:end -->\n\n## Widgets\n\n<!-- mcp:widgets:start -->\nWidget count: 17.\n\n- `ui://vocab-voyage/word-of-the-day` — Word of the Day (learn, 560x360) via `get_word_of_the_day`\n- `ui://vocab-voyage/flashcards` — Flashcards (learn, 560x460) via `get_flashcards`\n- `ui://vocab-voyage/quiz` — Quiz (learn, 560x520) via `generate_quiz`\n- `ui://vocab-voyage/study-plan` — Study Plan (learn, 600x600) via `study_plan_preview`\n- `ui://vocab-voyage/progress` — My Progress (progress, 600x640) via `get_my_progress`\n- `ui://vocab-voyage/game/word_match` — Game · Word Match (play, 620x640) via `play_game`\n- `ui://vocab-voyage/game/spelling_bee` — Game · Spelling Bee (play, 560x580) via `play_game`\n- `ui://vocab-voyage/game/speed_round` — Game · Speed Round (play, 560x600) via `play_game`\n- `ui://vocab-voyage/game/synonym_showdown` — Game · Synonym Showdown (play, 560x580) via `play_game`\n- `ui://vocab-voyage/game/word_scramble` — Game · Word Scramble (play, 560x580) via `play_game`\n- `ui://vocab-voyage/game/fill_in_blank` — Game · Fill in the Blank (play, 560x600) via `play_game`\n- `ui://vocab-voyage/game/context_clues` — Game · Context Clues (play, 600x620) via `play_game`\n- `ui://vocab-voyage/game/word_guess` — Game · Word Guess (play, 560x600) via `play_game`\n- `ui://vocab-voyage/game/picture_match` — Game · Picture Match (play, 600x620) via `play_game`\n- `ui://vocab-voyage/game/crossword` — Game · Crossword (play, 640x720) via `play_game`\n- `ui://vocab-voyage/game/word_search` — Game · Word Search (play, 640x720) via `play_game`\n- `ui://vocab-voyage/session-debrief` — Session Debrief (coach, 600x640) via `get_sparkle_guidance`\n<!-- mcp:widgets:end -->\n\n## Examples\n\n- [`examples/curl-quiz.sh`](./examples/curl-quiz.sh) — generate a 5-question SAT quiz with `curl`\n- [`examples/node-flashcards.mjs`](./examples/node-flashcards.mjs) — fetch a flashcard deck from Node 18+\n- [`examples/python-progress.py`](./examples/python-progress.py) — call the auth-only `get_my_progress` tool from Python\n\n## Manifests\n\nThe discovery + directory submission files live flat at the repo root so MCP\ndirectories can `git clone` and link straight to them:\n\n- `server-card.json` — MCP server card (canonical)\n- `apps.json` — interactive widget catalog\n- `agent-card.json` — A2A agent card\n- `mcp.json` — MCP discovery doc\n- `server.json` — MCP Registry submission manifest\n- `smithery.yaml` — Smithery directory listing\n- `clawhub.json` — ClawHub directory listing\n- `SKILL.md` — OpenClaw skill descriptor\n- `SUBMISSION_LINKS.md` — canonical `?ref=` slug list + Friday attribution query\n\nAll of the above are regenerated on every release by\n`scripts/build-mcp-repo.mjs` upstream — do not hand-edit them here.\n\n## License\n\n[MIT](./LICENSE) © Vocab Voyage\n",
  "bytes": 6364,
  "sha": "c4c37d63340009737df141fe21e98d817c40e97d90978a9dabba8a89847a9db3",
  "repo_slug": "jaideepdhanoa/vocab-voyage-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_jaideepdhanoa_vocab_voyage_c8b24457/readme"
}