Orb Platform
162K words, 226K lessons, 21K assessments, knowledge graph. Deterministic JSON.
Ask AI about Orb Platform
Powered by Claude Β· Grounded in docs
I know everything about Orb Platform. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
@lotd/word-orb
Language infrastructure for AI agents. 162,251 words. 47 languages. 240K audio files. Deterministic responses at the edge.
Part of the Orb Platform β dictionary, lessons, and assessments for AI that teaches.
What is Word Orb?
A dictionary API built for AI agents, educational platforms, and robotics. One API call returns:
- Definitions β accurate, etymology-backed, not hallucinated
- 47-language translations β native script + phonetic pronunciation
- Age-appropriate content β kid (5-12), teen, adult, and elder (65+) variants
- IPA pronunciation β standard phonetic notation for every word
- 240K audio files β native-speaker pronunciations via R2
Runs on Cloudflare Workers + D1. Sub-5ms edge delivery. Same input, same output, every time.
Install
npm install @lotd/word-orb
Quick Start
const { WordOrb } = require('@lotd/word-orb');
const orb = new WordOrb({ apiKey: 'wo_your_api_key' });
// Look up any word
const result = await orb.word('serendipity');
console.log(result.def); // Full definition
console.log(result.ipa); // /ΛsΙΙΉ.Ιn.ΛdΙͺp.Ιͺ.ti/
console.log(result.etym); // Etymology
console.log(result.langs); // 47-language translations
Get a free API key
const { key } = await orb.signup('you@example.com');
// Returns: wo_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
// 50 free lookups per day, upgrade anytime
MCP Integration (one line)
Add to your Claude Desktop claude_desktop_config.json:
{
"mcpServers": {
"word-orb": {
"url": "https://mcp.thedailylesson.com/mcp"
}
}
}
19 MCP tools across all three Orb Platform products. Works with Claude, Cursor, Windsurf, and any MCP-compatible agent.
The Orb Platform
Word Orb is one of three products:
| Product | What it does | Scale |
|---|---|---|
| Word Orb | Dictionary + translations + pronunciation | 162,251 words, 47 languages |
| Lesson Orb | Structured lesson plans | 226,725 lesson blocks, 5 phases, 10 archetypes |
| Quiz Orb | Assessment questions | 21,900 interactions, 6 question types |
All three share a knowledge graph with 30,288 connections linking words β lessons β quizzes.
Education Stack bundles all three for $179/mo (21% discount).
API Reference
new WordOrb(options?)
Create a client instance.
| Option | Type | Default | Description |
|---|---|---|---|
apiKey | string | β | Your wo_ API key (get one free) |
baseUrl | string | https://word-orb-api.nicoletterankin.workers.dev | API base URL |
orb.word(word) β Promise<WordResult>
Look up any word. Returns definition, pronunciation (IPA), part of speech, etymology, translations across 47 languages, and age-appropriate content.
const data = await orb.word('courage');
// {
// word: 'courage',
// ipa: '/ΛkΙΛrΙͺdΚ/',
// pos: 'noun',
// def: 'Courage is the ability to face fear, danger, or difficulty...',
// etym: 'From Old French "corage," meaning "heart, spirit"...',
// langs: { es: 'coraje', fr: 'courage', de: 'Mut', zh: 'εζ°', ... },
// tones: { child: '...', teen: '...', adult: '...' }
// }
orb.words() β Promise<WordListResult>
Get the full word library listing.
const { count, words } = await orb.words();
console.log(`${count} words available`);
orb.audit(email, words) β Promise<AuditResult>
Run a compliance audit on your agent's vocabulary. Returns coverage analysis, age-appropriateness gaps, and a compliance grade.
const report = await orb.audit('cto@company.com', [
'understand', 'help', 'teach', 'learn', 'discover'
]);
console.log(report.grade); // 'A-'
console.log(report.compliance_score); // 91
orb.feedback(word, vote, correction?) β Promise<{ ok: boolean }>
Submit vocabulary feedback.
await orb.feedback('serendipity', 1); // upvote
await orb.feedback('irregardless', -1, 'Not a word!'); // downvote + correction
orb.signup(email) β Promise<SignupResult>
Create a free API key instantly. 50 lookups per day.
const { key, tier, daily_limit } = await orb.signup('dev@company.com');
orb.me() β Promise<KeyStatus>
Check your API key usage, tier, and remaining calls.
const status = await orb.me();
console.log(status.tier); // 'starter'
console.log(status.remaining_today); // 4873
orb.health() β Promise<HealthResult>
Check service health.
const health = await orb.health();
// { status: 'healthy', checks: { kv: 'ok', d1: 'ok (162250 words)', ... } }
orb.stats() β Promise<StatsResult>
Get database and usage statistics.
Pricing
| Tier | Price | API Calls/Day | Best For |
|---|---|---|---|
| Free | $0 | 50 | Prototyping, evaluation |
| Starter | $49/mo | 5,000 | Side projects, small apps |
| Growth | $149/mo | 50,000 | Production agents, teams |
| Enterprise | $499/mo | Unlimited | Scale, SLA, priority support |
Error Handling
try {
const result = await orb.word('nonexistent');
} catch (err) {
if (err.status === 401) console.error('Invalid API key');
else if (err.status === 429) console.error('Rate limit reached');
else if (err.status === 404) console.error('Word not found');
else console.error('API error:', err.message);
}
TypeScript
Full TypeScript definitions included:
import { WordOrb, WordResult } from '@lotd/word-orb';
const orb = new WordOrb({ apiKey: process.env.WORD_ORB_KEY });
const result: WordResult = await orb.word('ephemeral');
Examples
See the examples/ directory:
langchain-tool.jsβ Use Word Orb as a LangChain toolcrewai-agent.pyβ CrewAI agent with Word Orb vocabularyopenai-function.jsβ OpenAI function calling integrationmcp-config.jsonβ Claude Desktop MCP configuration
Links
- Playground β Try all three products live
- Pricing & Signup
- API Docs
- MCP Server β 19 tools for agent frameworks
- npm
About
Built by Lesson of the Day PBC. Language infrastructure for AI agents that need to get words right.
License
MIT
