Vocab Voyage Agent Resources
This is the structured agent-mode view for https://vocab.voyage/?mode=agent. It is rendered before any JavaScript runs so AI crawlers and orank-style scanners can extract endpoints, scopes, and discovery URLs without executing scripts.
Vocab Voyage exposes vocabulary learning resources for AI agents through a zero-auth REST API, OpenAPI, llms.txt, MCP discovery, MCP Apps UI resources, NLWeb /ask, 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
NLWeb /ask
POST natural-language questions to https://gponcrussdahcdyrlhcr.supabase.co/functions/v1/nlweb-ask. Responses follow the NLWeb shape with _meta. Send prefer.streaming: true in the body or Accept: text/event-stream for SSE streaming with start, result, and complete events.
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. Voyager is $6/mo or $50/yr. Explorer is $9/mo or $75/yr. Odyssey is the family/premium tier (4 members included, additional seats $3/mo). Full plan details: https://vocab.voyage/pricing.md.