Vocab Voyage

Official31 toolsLive

by jaideepdhanoa

20 MCP tools + 17 widgets for SAT/ISEE/SSAT/GRE/GMAT/LSAT prep. Flashcards, quizzes & games. Hosted.

io.github.jaideepdhanoa/vocab-voyage MCP Server

The Vocab Voyage MCP server provides a public mirror of the Model Context Protocol tools and widgets for vocabulary learning and standardized test prep. It bundles 20 MCP tools and 17 interactive widgets, with hosted access and optional personal tokens for personalization.

🛠️ Key Features

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 deployment with no install required
Optional personal tokens for personalized features

🚀 Use Cases

Vocabulary learning for SAT/ISEE/SSAT/GRE/GMAT/LSAT prep
Self-guided study plans and progress monitoring
Interactive quizzes and flashcards for spaced repetition

⚡ Developer Benefits

Official public mirror of the Vocab Voyage MCP server
Grounded in a broad set of tools and widgets for flexible integration
Clear hosting URL reference for integration and testing

⚠️ Limitations

Source data notes hosted URL and token-based personalization; specifics may vary by deployment
Description centered on 20 tools + 17 widgets; exact tool/widget mapping may evolve

Captured live from the server via tools/list.

get_word_of_the_day

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), optionally scoped to a test family (isee, ssat, sat, psat, gre, gmat, lsat, general). Do not use for arbitrary lookups — call get_definition instead.

Parameters1

test_family

string

optional

Optional test family: isee, ssat, sat, psat, gre, gmat, lsat, general

Raw schema

{
  "type": "object",
  "properties": {
    "test_family": {
      "type": "string",
      "description": "Optional test family: isee, ssat, sat, psat, gre, gmat, lsat, general"
    }
  }
}

get_definition

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. Do not use for sentence-level meaning disambiguation (call explain_word_in_context) or for daily word prompts (call get_word_of_the_day).

Parameters1

word

string

required

The word to define

Raw schema

{
  "type": "object",
  "properties": {
    "word": {
      "type": "string",
      "description": "The word to define"
    }
  },
  "required": [
    "word"
  ]
}

generate_quiz

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, gre, gmat, lsat, general). Renders the interactive Vocab Voyage quiz widget on supporting hosts; per-answer taps persist mastery for signed-in users. Do not use for definition lookups — call get_definition instead. Do not use for spaced-repetition flashcards — call get_flashcards instead.

Parameters3

test_family	string	required
level	string	optional	Optional difficulty hint
count	number	optional	Number of questions (1–10), default 5

Raw schema

{
  "type": "object",
  "properties": {
    "test_family": {
      "type": "string"
    },
    "level": {
      "type": "string",
      "description": "Optional difficulty hint"
    },
    "count": {
      "type": "number",
      "description": "Number of questions (1–10), default 5"
    }
  },
  "required": [
    "test_family"
  ]
}

get_course_word_list

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

Parameters2

course_slug	string	required
limit	number	optional	1–50, default 20

Raw schema

{
  "type": "object",
  "properties": {
    "course_slug": {
      "type": "string"
    },
    "limit": {
      "type": "number",
      "description": "1–50, default 20"
    }
  },
  "required": [
    "course_slug"
  ]
}

list_courses

Lists all 13 Vocab Voyage courses with their slugs and descriptions.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

explain_word_in_context

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

Parameters2

word	string	required
sentence	string	required	The sentence containing the word

Raw schema

{
  "type": "object",
  "properties": {
    "word": {
      "type": "string"
    },
    "sentence": {
      "type": "string",
      "description": "The sentence containing the word"
    }
  },
  "required": [
    "word",
    "sentence"
  ]
}

study_plan_preview

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 Voyage study-plan widget on supporting hosts; tapping 'Start Day N' launches a flashcard session seeded with that day's words. Do not use for a single quiz session — call generate_quiz instead. Do not use for one-off lookups — call get_definition instead.

Parameters2

test_family	string	required
target_date	string	optional	Optional ISO date (YYYY-MM-DD)

Raw schema

{
  "type": "object",
  "properties": {
    "test_family": {
      "type": "string"
    },
    "target_date": {
      "type": "string",
      "description": "Optional ISO date (YYYY-MM-DD)"
    }
  },
  "required": [
    "test_family"
  ]
}

get_flashcards

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 flashcards widget on supporting hosts; per-card 'I knew it / I didn't' buttons persist mastery for signed-in users. Do not use for multiple-choice testing (call generate_quiz) or for a single word lookup (call get_definition).

Parameters2

test_family	string	optional	isee, ssat, sat, psat, gre, gmat, lsat, general
count	number	optional	Number of cards (1–12), default 5

Raw schema

{
  "type": "object",
  "properties": {
    "test_family": {
      "type": "string",
      "description": "isee, ssat, sat, psat, gre, gmat, lsat, general"
    },
    "count": {
      "type": "number",
      "description": "Number of cards (1–12), default 5"
    }
  }
}

get_my_progress

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 widget on supporting hosts; falls back to markdown elsewhere. Anonymous callers receive a sign-in prompt. Do not use for global stats or other users' progress.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

play_game

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-voyage/game/{slug} widget on supporting hosts; falls back to a deep link elsewhere. 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. Do not use for a serious test-prep quiz — call generate_quiz instead.

Parameters3

slug	string	required	Game slug: word_match \| spelling_bee \| speed_round \| synonym_showdown \| word_scramble \| fill_in_blank \| context_clues \| word_guess \| picture_match \| crossword \| word_search
test_family	string	optional	Optional: isee, ssat, sat, psat, gre, gmat, lsat, general
count	number	optional	Words in the round (4–12, default 8)

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Game slug: word_match | spelling_bee | speed_round | synonym_showdown | word_scramble | fill_in_blank | context_clues | word_guess | picture_match | crossword | word_search"
    },
    "test_family": {
      "type": "string",
      "description": "Optional: isee, ssat, sat, psat, gre, gmat, lsat, general"
    },
    "count": {
      "type": "number",
      "description": "Words in the round (4–12, default 8)"
    }
  },
  "required": [
    "slug"
  ]
}

record_word_result

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.

Parameters7

word	string	optional	The word answered (preferred for human input).
card_id	string	optional	Card UUID (preferred when known from a prior tool result).
is_correct	boolean	required
quiz_attempt_id	string	optional	Optional quiz_attempt UUID to record a per-question row.
selected_answer	string	optional
time_taken_seconds	number	optional
question_type	string	optional	e.g. multiple_choice, fill_in_blank, flashcard.

Raw schema

{
  "type": "object",
  "properties": {
    "word": {
      "type": "string",
      "description": "The word answered (preferred for human input)."
    },
    "card_id": {
      "type": "string",
      "description": "Card UUID (preferred when known from a prior tool result)."
    },
    "is_correct": {
      "type": "boolean"
    },
    "quiz_attempt_id": {
      "type": "string",
      "description": "Optional quiz_attempt UUID to record a per-question row."
    },
    "selected_answer": {
      "type": "string"
    },
    "time_taken_seconds": {
      "type": "number"
    },
    "question_type": {
      "type": "string",
      "description": "e.g. multiple_choice, fill_in_blank, flashcard."
    }
  },
  "required": [
    "is_correct"
  ]
}

record_session_complete

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.

Parameters7

deck_id	string	optional	Optional deck UUID; omit for ad-hoc MCP sessions.
cards_studied	number	required
time_spent_seconds	number	required
session_type	string	optional	e.g. mcp_word_match, mcp_flashcard, mcp_quiz.
session_title	string	optional
correct_count	number	optional
total_count	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "deck_id": {
      "type": "string",
      "description": "Optional deck UUID; omit for ad-hoc MCP sessions."
    },
    "cards_studied": {
      "type": "number"
    },
    "time_spent_seconds": {
      "type": "number"
    },
    "session_type": {
      "type": "string",
      "description": "e.g. mcp_word_match, mcp_flashcard, mcp_quiz."
    },
    "session_title": {
      "type": "string"
    },
    "correct_count": {
      "type": "number"
    },
    "total_count": {
      "type": "number"
    }
  },
  "required": [
    "cards_studied",
    "time_spent_seconds"
  ]
}

award_game_xp

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

Parameters2

xp	number	required	XP to award (>= 0).
reason	string	optional	Optional human label for analytics.

Raw schema

{
  "type": "object",
  "properties": {
    "xp": {
      "type": "number",
      "description": "XP to award (>= 0)."
    },
    "reason": {
      "type": "string",
      "description": "Optional human label for analytics."
    }
  },
  "required": [
    "xp"
  ]
}

mark_word_known

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

Parameters2

word	string	optional
card_id	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "word": {
      "type": "string"
    },
    "card_id": {
      "type": "string"
    }
  }
}

mark_word_difficult

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

Parameters2

word	string	optional
card_id	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "word": {
      "type": "string"
    },
    "card_id": {
      "type": "string"
    }
  }
}

update_adaptive_level

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

Parameters4

course_id	string	optional
words_studied	number	required
correct_count	number	required
total_count	number	required

Raw schema

{
  "type": "object",
  "properties": {
    "course_id": {
      "type": "string"
    },
    "words_studied": {
      "type": "number"
    },
    "correct_count": {
      "type": "number"
    },
    "total_count": {
      "type": "number"
    }
  },
  "required": [
    "words_studied",
    "correct_count",
    "total_count"
  ]
}

file_support_ticket

File a real human-followup support ticket on behalf of the signed-in user. Use this when the user reports a billing problem, bug, account lockout, complaint about a tutor, or anything Sparkle/the agent cannot resolve from data. The ticket is emailed to the support team and a confirmation is sent to the user with a 1-business-day SLA. Categories: billing, bug, account, complaint, feedback, other. Requires sign-in.

Parameters3

category	string	required	Issue category. Use 'billing' for refunds/charges, 'bug' for crashes/data loss, 'account' for lockouts/access, 'complaint' for tutor/quality issues, 'feedback' for feature requests.
summary	string	required	One-line description of the issue (what the user needs).
conversation_snippet	string	optional	Optional: last few turns of the conversation for context.

Raw schema

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "billing",
        "bug",
        "account",
        "complaint",
        "feedback",
        "other"
      ],
      "description": "Issue category. Use 'billing' for refunds/charges, 'bug' for crashes/data loss, 'account' for lockouts/access, 'complaint' for tutor/quality issues, 'feedback' for feature requests."
    },
    "summary": {
      "type": "string",
      "minLength": 4,
      "maxLength": 500,
      "description": "One-line description of the issue (what the user needs)."
    },
    "conversation_snippet": {
      "type": "string",
      "maxLength": 2000,
      "description": "Optional: last few turns of the conversation for context."
    }
  },
  "required": [
    "category",
    "summary"
  ]
}

get_recent_mistakes

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 miss-rate and last-seen timestamp, plus a link to the in-app Recent Mistakes page. SUMMARISE — never dump every row; tell the user the count, name 2–3 sample words, and recommend the page URL. Requires sign-in.

Parameters2

days	number	optional	Lookback window in days (1–90, default 7)
limit	number	optional	Max words to return (1–50, default 10)

Raw schema

{
  "type": "object",
  "properties": {
    "days": {
      "type": "number",
      "description": "Lookback window in days (1–90, default 7)"
    },
    "limit": {
      "type": "number",
      "description": "Max words to return (1–50, default 10)"
    }
  }
}

get_session_detail

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_sessions.id, usually obtained from get_recent_session_results / a picker chip). Returns title, accuracy %, wrong_words[] (max 10), and a per-card timeline (truncated to first 20 events). Cite at least one wrong word and the accuracy in your reply.

Parameters2

session_id	string	required	study_sessions.id or adaptive_sessions.id (UUID)
include_timeline	boolean	optional	Include per-card timeline (default true). Truncated to 20 events.

Raw schema

{
  "type": "object",
  "properties": {
    "session_id": {
      "type": "string",
      "description": "study_sessions.id or adaptive_sessions.id (UUID)"
    },
    "include_timeline": {
      "type": "boolean",
      "description": "Include per-card timeline (default true). Truncated to 20 events."
    }
  },
  "required": [
    "session_id"
  ]
}

get_pending_invites

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 invite has hours_until_expiry < 24 (and not expired), proactively offer to resend it via the resend-parent-invite flow. If expired, offer to send a fresh invite. Requires sign-in.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

nudge_child

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 today'. The server enforces a 24h cooldown per child — if rate-limited the response includes retry_after_hours. NEVER spoof a different parent — the calling user must already be linked to the child. Requires sign-in.

Parameters3

child_user_id	string	required	user_id of the linked child to nudge
reason	string	optional	Optional short reason (≤200 chars), e.g. 'streak at risk'
message	string	optional	Optional personal message (≤280 chars) shown to the child

Raw schema

{
  "type": "object",
  "properties": {
    "child_user_id": {
      "type": "string",
      "description": "user_id of the linked child to nudge"
    },
    "reason": {
      "type": "string",
      "description": "Optional short reason (≤200 chars), e.g. 'streak at risk'"
    },
    "message": {
      "type": "string",
      "description": "Optional personal message (≤280 chars) shown to the child"
    }
  },
  "required": [
    "child_user_id"
  ]
}

resend_pending_invite

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 generated. 60s per-invite cooldown. Caller must own the invite. Requires sign-in.

Parameters1

invite_id

string

required

The id field returned by get_pending_invites.

Raw schema

{
  "type": "object",
  "properties": {
    "invite_id": {
      "type": "string",
      "description": "The id field returned by get_pending_invites."
    }
  },
  "required": [
    "invite_id"
  ]
}

get_class_standing

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 class plus a winnable rival suggestion (similar weekly XP). NEVER name the class leader unless the user is rank #1 — the response uses '(top student)' as a deliberate placeholder. Renders the interactive class-standing widget on supporting hosts; falls back to markdown elsewhere. Anonymous callers receive a sign-in prompt.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

get_sparkle_guidance

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.

Parameters1

persona

string

optional

Optional persona override: student | parent | tutor | explorer.

Raw schema

{
  "type": "object",
  "properties": {
    "persona": {
      "type": "string",
      "description": "Optional persona override: student | parent | tutor | explorer."
    }
  }
}

set_persona

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.

Parameters1

persona

string

required

student | parent | tutor | explorer

Raw schema

{
  "type": "object",
  "properties": {
    "persona": {
      "type": "string",
      "description": "student | parent | tutor | explorer"
    }
  },
  "required": [
    "persona"
  ]
}

get_recommended_next_action

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.

Parameters1

persona

string

optional

Optional persona override.

Raw schema

{
  "type": "object",
  "properties": {
    "persona": {
      "type": "string",
      "description": "Optional persona override."
    }
  }
}

list_starter_prompts

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

get_session_trends

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 / am I improving / which words keep tripping me up'.

Parameters1

days

number

optional

Window size in days (default 14, max 90).

Raw schema

{
  "type": "object",
  "properties": {
    "days": {
      "type": "number",
      "description": "Window size in days (default 14, max 90)."
    }
  }
}

get_class_session_trends

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 classes plus 1–3 struggling students.

Parameters2

class_id	string	optional	Optional class id to scope to one class.
days	number	optional	Window size in days (default 14, max 30).

Raw schema

{
  "type": "object",
  "properties": {
    "class_id": {
      "type": "string",
      "description": "Optional class id to scope to one class."
    },
    "days": {
      "type": "number",
      "description": "Window size in days (default 14, max 30)."
    }
  }
}

get_child_session_detail

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 `child_user_id` / `session_id` is supplied. Ownership-gated: returns an error for unlinked children.

Parameters2

child_user_id	string	optional	Optional. Defaults to first linked child.
session_id	string	optional	Optional. Defaults to the child's most recent session.

Raw schema

{
  "type": "object",
  "properties": {
    "child_user_id": {
      "type": "string",
      "description": "Optional. Defaults to first linked child."
    },
    "session_id": {
      "type": "string",
      "description": "Optional. Defaults to the child's most recent session."
    }
  }
}

get_study_plan_recommendation

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 recent trends. Inline only the first 3 days; full plan persists when the user clicks the Vocab Voyage start link.

Parameters1

horizon_days

number

optional

Plan length in days (3–7, default 7).

Raw schema

{
  "type": "object",
  "properties": {
    "horizon_days": {
      "type": "number",
      "description": "Plan length in days (3–7, default 7)."
    }
  }
}

README.md6 KBView on GitHub

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:

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

bash

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, 600x600) via study_plan_preview
ui://vocab-voyage/progress — My Progress (progress, 600x640) via get_my_progress
ui://vocab-voyage/game/word_match — Game · Word Match (play, 620x640) via play_game
ui://vocab-voyage/game/spelling_bee — Game · Spelling Bee (play, 560x580) via play_game
ui://vocab-voyage/game/speed_round — Game · Speed Round (play, 560x600) via play_game
ui://vocab-voyage/game/synonym_showdown — Game · Synonym Showdown (play, 560x580) via play_game
ui://vocab-voyage/game/word_scramble — Game · Word Scramble (play, 560x580) via play_game
ui://vocab-voyage/game/fill_in_blank — Game · Fill in the Blank (play, 560x600) via play_game
ui://vocab-voyage/game/context_clues — Game · Context Clues (play, 600x620) via play_game
ui://vocab-voyage/game/word_guess — Game · Word Guess (play, 560x600) via play_game
ui://vocab-voyage/game/picture_match — Game · Picture Match (play, 600x620) via play_game
ui://vocab-voyage/game/crossword — Game · Crossword (play, 640x720) via play_game
ui://vocab-voyage/game/word_search — Game · Word Search (play, 640x720) via play_game
ui://vocab-voyage/session-debrief — Session Debrief (coach, 600x640) via get_sparkle_guidance

Examples

examples/curl-quiz.sh — generate a 5-question SAT quiz with curl
examples/node-flashcards.mjs — fetch a flashcard deck from Node 18+
examples/python-progress.py — call the auth-only get_my_progress tool from Python

Manifests

The discovery + directory submission files live flat at the repo root so MCP directories can git clone and link straight to them:

server-card.json — MCP server card (canonical)
apps.json — interactive widget catalog
agent-card.json — A2A agent card
mcp.json — MCP discovery doc
server.json — MCP Registry submission manifest
smithery.yaml — Smithery directory listing
clawhub.json — ClawHub directory listing
SKILL.md — OpenClaw skill descriptor
SUBMISSION_LINKS.md — canonical ?ref= slug list + Friday attribution query

All of the above are regenerated on every release by scripts/build-mcp-repo.mjs upstream — do not hand-edit them here.

License

Install

Tools (31)

get_word_of_the_dayget_definitiongenerate_quizget_course_word_listlist_coursesexplain_word_in_contextstudy_plan_previewget_flashcards

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://gponcrussdahcdyrlhcr.supabase.co/functions/v1/mcp-server?ref=mcp_registry

Add to VS Code Add to Cursor

claude_desktop_config.json

json

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

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.jaideepdhanoa/vocab-voyage MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

get_word_of_the_day

get_definition

generate_quiz

get_course_word_list

list_courses

explain_word_in_context

study_plan_preview

get_flashcards

get_my_progress

play_game

record_word_result

record_session_complete

award_game_xp

mark_word_known

mark_word_difficult

update_adaptive_level

file_support_ticket

get_recent_mistakes

get_session_detail

get_pending_invites

nudge_child

resend_pending_invite

get_class_standing

get_sparkle_guidance

set_persona

get_recommended_next_action

list_starter_prompts

get_session_trends

get_class_session_trends

get_child_session_detail

get_study_plan_recommendation

Vocab Voyage MCP Server

Install

Claude Desktop

ChatGPT Apps SDK / Cursor / Cline

OpenClaw

Tools

Widgets

Examples

Manifests

License

Install

Remote endpoint

Related servers