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:

• A definition with part of speech, example sentence, synonyms, antonyms
• A multiple-choice vocabulary quiz scoped to a specific test
• A list of vocabulary words from a specific test-prep course
• A 7-day study plan preview
• An explanation of what a word means inside a specific sentence
• The Word of the Day (general or test-scoped)

Endpoints#

• MCP server: https://gponcrussdahcdyrlhcr.supabase.co/functions/v1/mcp-server
• Public REST API: https://gponcrussdahcdyrlhcr.supabase.co/functions/v1/vocab-api
• Natural-language /ask: https://gponcrussdahcdyrlhcr.supabase.co/functions/v1/nlweb-ask (POST {"query": "..."}, supports SSE via prefer.streaming: true)
• OpenAPI spec: https://vocab.voyage/openapi.json
• Server card: https://vocab.voyage/.well-known/mcp/server-card.json
• Agent card: https://vocab.voyage/.well-known/agent-card.json
• Auth + scopes reference: https://vocab.voyage/developers/auth
• Live demo + docs: https://vocab.voyage/mcp

Tools#

ToolPurposeget_word_of_the_dayToday's vocab word, optionally scoped to a test familyget_definitionDefinition, part of speech, example, synonyms/antonymsgenerate_quizMultiple-choice quiz (1–10 questions) for a test familyget_course_word_listSample words from a specific courselist_coursesAll 13 test-prep courses with slugs and descriptionsexplain_word_in_contextExplain a word inside a specific sentencestudy_plan_preview7-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:

ToolWidgetget_definition``ui://vocab-voyage/definition — definition card with example + synonymsgenerate_quiz``ui://vocab-voyage/quiz — interactive multiple-choice quizstudy_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:

text

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#

ScopeGrantsmcp.readRead MCP metadata and public tool results. Required for any MCP usage.mcp.toolsInvoke public MCP tools (definition, quiz, courses, study plan).profile.readRead connected user's display name, account type, preferred course.progress.readRead mastery, streaks, and recent sessions for the connected user.

Rate limits#

• Anonymous: 60 req/min per IP
• Authenticated: 600 req/hour per user

Example prompts#

• Define "aberrant" and give a test-prep example.
• Generate a 5-question SAT vocabulary quiz.
• List Vocab Voyage courses for ISEE and SSAT.
• Build a 7-day GRE vocabulary study plan preview.
• Explain "table" in the sentence: "Let's table this discussion."

Error format#

All errors are structured JSON:

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.