Vocab Voyage Mcp

Provides vocabulary definitions, quizzes, word lists, study plans, and context explanations for academic and test-prep exams including ISEE, SSAT, SAT, GRE,...

Security Scan

The skill is an instruction-only wrapper pointing at a hosted Vocab Voyage MCP server and its requirements and instructions are consistent with a vocabulary/test‑prep service.

Purpose & Capability

Name, description, and declared tools line up with the listed remote endpoints and UI widgets; nothing in the manifests or SKILL.md requests unrelated credentials or unusual capabilities.

Instruction Scope

SKILL.md and manifests instruct clients to call the listed Supabase-hosted MCP endpoints and provide optional personal tokens for personalized features. README includes optional integration guidance (e.g., editing local Claude Desktop config and using `npx mcp-remote`) which are user actions outside normal agent runtime but could pull remote code if followed—this is a user-side install/integration recommendation, not an agent runtime requirement.

Install Mechanism

No install spec is declared and the skill is instruction-only (hosted remote endpoint). The only install-like guidance appears in README for client integration (using `npx mcp-remote`) which is optional for some desktop clients.

Credentials

The skill requires no environment variables or credentials for public tools; an optional per-user `vv_mcp_…` token is documented and scoped (mcp.read, mcp.tools, profile.read, progress.read) — this matches the stated personalized features and is proportionate.

Persistence & Privilege

always is false and the skill does not request elevated or persistent system privileges. It does not modify other skills or system configs itself; any local config edits suggested are user-facing instructions, not automatic actions by the skill.

Assessment

This is a hosted vocabulary/test‑prep service — anonymous use works for public tools and a personal `vv_mcp_…` token is only needed for personalized features (mastery, progress). Before installing or supplying a token: (1) verify you trust https://vocab.voyage and the Supabase function domain listed; (2) prefer anonymous access if you do not need personalized data; (3) be cautious following README integration steps that run `npx` (these download and run code on your machine) or that tell you to edit local config files; only do those if you trust the source. The repo records and recommends `?ref=` or `x-install-source` query/header for attribution — that’s analytics, not a credential exfiltration mechanism. If you want more assurance, inspect the live OpenAPI / well-known discovery URLs listed in the manifests before providing a personal token.

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

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

• 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:

{ "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.