Vocab Voyage Agent Resources
Vocab Voyage exposes vocabulary learning resources for AI agents through a zero-auth REST API, OpenAPI, llms.txt, MCP discovery, MCP Apps UI resources, and structured pricing documentation.
Public REST API
Base URL: https://gponcrussdahcdyrlhcr.supabase.co/functions/v1/vocab-api
| Health | GET /health |
|---|---|
| Definition | GET /definition?word=aberrant |
| Word of the day | GET /word-of-the-day?test_family=sat |
| Courses | GET /courses |
| Course words | GET /course-word-list?course_slug=sat-vocab&limit=20 |
| Quiz | GET /quiz?test_family=sat&count=5 |
| Study plan | GET /study-plan-preview?test_family=sat |
MCP discovery
- MCP endpoint: https://gponcrussdahcdyrlhcr.supabase.co/functions/v1/mcp-server
- Primary discovery: https://vocab.voyage/.well-known/mcp.json
- Server card: https://vocab.voyage/.well-known/mcp/server-card.json
- MCP Apps resources: https://vocab.voyage/.well-known/mcp/apps.json
Auth scopes and limits
REST endpoints require no authentication. Optional MCP personal tokens begin with vv_mcp_ and can include mcp.read, mcp.tools, profile.read, and progress.read. Anonymous REST traffic is 60 requests/minute per IP; authenticated MCP traffic is 600 requests/hour per user.
Structured errors
Errors use JSON fields error_code, message, hint, and retry_after. Agents should honor Retry-After, X-RateLimit-Limit, and X-RateLimit-Remaining.
Pricing summary
Starter is free. Paid plans and family access are documented at https://vocab.voyage/pricing.md.