Get Started in 5 Minutes

Get your API key

Sign up for a free tier — 50 API calls per day, all 4 products included.

curl -X POST -H "Content-Type: application/json" \
  -d '{"email":"you@company.com"}' \
  https://word-orb-api.nicoletterankin.workers.dev/api/signup

{
  "key": "wo_abc123...",
  "tier": "free",
  "daily_limit": 50,
  "message": "Welcome to Orb Platform!"
}

Look up your first word

Get the definition, IPA, etymology, translations in 47 languages, and age-appropriate tones for any English word.

curl -H "Authorization: Bearer wo_YOUR_KEY" \
  https://word-orb-api.nicoletterankin.workers.dev/api/word/courage

const res = await fetch("https://word-orb-api.nicoletterankin.workers.dev/api/word/courage", {
  headers: { "Authorization": "Bearer wo_YOUR_KEY" }
});
const word = await res.json();
console.log(word.def);     // definition
console.log(word.ipa);     // /ˈkɜːɹ.ɪdʒ/
console.log(word.langs.ES); // Spanish translation

import requests

r = requests.get("https://word-orb-api.nicoletterankin.workers.dev/api/word/courage",
    headers={"Authorization": "Bearer wo_YOUR_KEY"})
word = r.json()
print(word["def"])      # definition
print(word["langs"])    # 47 translations

{
  "word": "courage",
  "ipa": "/ˈkɜːɹ.ɪdʒ/",
  "pos": "noun",
  "def": "The ability to do something that frightens one; bravery.",
  "etym": "From Old French corage, from Latin cor 'heart'...",
  "langs": { "ES": "coraje", "FR": "courage", "ZH": "勇气", "AR": "شجاعة", ... },
  "tones": [
    { "age": "child", "explanation": "Being brave even when you're scared..." },
    { "age": "teen", "explanation": "..." },
    { "age": "adult", "explanation": "..." },
    { "age": "elder", "explanation": "..." }
  ]
}

Get a structured lesson

Retrieve a 5-phase lesson (hook → story → wonder → action → wisdom) from 226K lesson blocks across 4 tracks and 10 teaching archetypes.

curl -H "Authorization: Bearer wo_YOUR_KEY" \
  "https://word-orb-api.nicoletterankin.workers.dev/api/lesson?day=47&track=learn&archetype=explorer"

const res = await fetch(
  "https://word-orb-api.nicoletterankin.workers.dev/api/lesson?day=47&track=learn&archetype=explorer",
  { headers: { "Authorization": "Bearer wo_YOUR_KEY" } }
);
const lesson = await res.json();
console.log(lesson.phases.hook);    // opening hook
console.log(lesson.phases.wisdom);  // closing wisdom

r = requests.get("https://word-orb-api.nicoletterankin.workers.dev/api/lesson",
    params={"day": 47, "track": "learn", "archetype": "explorer"},
    headers={"Authorization": "Bearer wo_YOUR_KEY"})
lesson = r.json()
for phase in ["hook", "story", "wonder", "action", "wisdom"]:
    print(f"{phase}: {lesson['phases'][phase][:80]}...")

{
  "day": 47,
  "track": "learn",
  "title": "The Architecture of Resilience",
  "archetype": "explorer",
  "phases": {
    "hook":   "What if the strongest material in nature...",
    "story":  "In 1928, a Scottish bacteriologist...",
    "wonder": "Consider this: every language has a word for...",
    "action": "Find three examples in your environment...",
    "wisdom": "Resilience isn't about never breaking..."
  }
}

Run a quiz

Get assessment questions aligned to any lesson — multiple choice, true/false, open-ended, and reflection prompts.

curl -H "Authorization: Bearer wo_YOUR_KEY" \
  "https://word-orb-api.nicoletterankin.workers.dev/api/quiz?day=47&track=learn"

[
  { "type": "mc", "prompt": "Which phase of resilience...", "choices": [...], "answer": "B" },
  { "type": "tf", "prompt": "Resilience requires...", "answer": "true" },
  { "type": "open", "prompt": "Describe a time when...", "answer": null },
  { "type": "reflection", "prompt": "How does resilience connect to...", "answer": null }
]

Connect an AI agent (MCP)

One line of config gives Claude, ChatGPT, Cursor, or any MCP-compatible AI client access to all 4 Orb products as tools.

{
  "mcpServers": {
    "word-orb": {
      "url": "https://mcp.thedailylesson.com/mcp"
    }
  }
}

Add this to your MCP client's config file. The AI agent discovers Word Orb, Lesson Orb, Quiz Orb, and the Knowledge Graph automatically — no SDK, no wrapper code.