Vocab Voyage Mcp
by @jaideepdhanoa
Provides vocabulary definitions, quizzes, word lists, study plans, and context explanations for academic and test-prep exams including ISEE, SSAT, SAT, GRE,...
clawhub install vocab-voyage-mcpπ About This Skill
Vocab Voyage β MCP Skill
Vocabulary tutor and standardized test prep tools for ISEE, SSAT, SAT, PSAT, GRE, GMAT, LSAT and general academic vocabulary. Hosted MCP server β no install required.
When to use
Invoke Vocab Voyage when a user needs:
Endpoints
https://gponcrussdahcdyrlhcr.supabase.co/functions/v1/mcp-serverhttps://gponcrussdahcdyrlhcr.supabase.co/functions/v1/vocab-api/ask: https://gponcrussdahcdyrlhcr.supabase.co/functions/v1/nlweb-ask (POST {"query": "..."}, supports SSE via prefer.streaming: true)Tools
| Tool | Purpose |
|---|---|
| get_word_of_the_day | Today's vocab word, optionally scoped to a test family |
| get_definition | Definition, part of speech, example, synonyms/antonyms |
| generate_quiz | Multiple-choice quiz (1β10 questions) for a test family |
| get_course_word_list | Sample words from a specific course |
| list_courses | All 13 test-prep courses with slugs and descriptions |
| explain_word_in_context | Explain a word inside a specific sentence |
| study_plan_preview | 7-day, 5-words-per-day sample plan |
MCP Apps UI widgets
For agents that support MCP Apps, three tools attach a renderable widget via _meta.ui.resourceUri:
| Tool | Widget |
|---|---|
| get_definition | ui://vocab-voyage/definition β definition card with example + synonyms |
| generate_quiz | ui://vocab-voyage/quiz β interactive multiple-choice quiz |
| study_plan_preview | ui://vocab-voyage/study-plan β 7-day plan grid |
Manifest: https://vocab.voyage/.well-known/mcp/apps.json
Authentication
Anonymous access works for every public tool β no token required.
For personalized tools (mastery, streaks, profile-aware sessions), pass a personal MCP token:
Authorization: Bearer vv_mcp_β¦
Where to get a token
1. Sign in at https://vocab.voyage/auth
2. Open https://vocab.voyage/mcp
3. Click Generate token, choose scopes, copy the vv_mcp_β¦ value (shown once)
Full reference, rotation, and revocation: https://vocab.voyage/developers/auth
Scopes
| Scope | Grants |
|---|---|
| mcp.read | Read MCP metadata and public tool results. Required for any MCP usage. |
| mcp.tools | Invoke public MCP tools (definition, quiz, courses, study plan). |
| profile.read | Read connected user's display name, account type, preferred course. |
| progress.read | Read mastery, streaks, and recent sessions for the connected user. |
Rate limits
Example prompts
Error format
All errors are structured JSON:
{ "error_code": "string", "message": "string", "hint": "string", "retry_after": 0 }
Common error_code values: unauthorized, insufficient_scope, token_revoked, rate_limited, invalid_request, not_found, server_error.