{
  "markdown": "# @lotd/word-orb\n\nLanguage infrastructure for AI agents. 162,251 words. 47 languages. 240K audio files. Deterministic responses at the edge.\n\nPart of the [Orb Platform](https://word-orb-api.nicoletterankin.workers.dev/pricing) — dictionary, lessons, and assessments for AI that teaches.\n\n[![npm](https://img.shields.io/npm/v/@lotd/word-orb)](https://www.npmjs.com/package/@lotd/word-orb)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n## What is Word Orb?\n\nA dictionary API built for AI agents, educational platforms, and robotics. One API call returns:\n\n- **Definitions** — accurate, etymology-backed, not hallucinated\n- **47-language translations** — native script + phonetic pronunciation\n- **Age-appropriate content** — kid (5-12), teen, adult, and elder (65+) variants\n- **IPA pronunciation** — standard phonetic notation for every word\n- **240K audio files** — native-speaker pronunciations via R2\n\nRuns on Cloudflare Workers + D1. Sub-5ms edge delivery. Same input, same output, every time.\n\n## Install\n\n```bash\nnpm install @lotd/word-orb\n```\n\n## Quick Start\n\n```js\nconst { WordOrb } = require('@lotd/word-orb');\n\nconst orb = new WordOrb({ apiKey: 'wo_your_api_key' });\n\n// Look up any word\nconst result = await orb.word('serendipity');\nconsole.log(result.def);    // Full definition\nconsole.log(result.ipa);    // /ˌsɛɹ.ən.ˈdɪp.ɪ.ti/\nconsole.log(result.etym);   // Etymology\nconsole.log(result.langs);  // 47-language translations\n```\n\n### Get a free API key\n\n```js\nconst { key } = await orb.signup('you@example.com');\n// Returns: wo_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\n// 50 free lookups per day, upgrade anytime\n```\n\n### MCP Integration (one line)\n\nAdd to your Claude Desktop `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"word-orb\": {\n      \"url\": \"https://mcp.thedailylesson.com/mcp\"\n    }\n  }\n}\n```\n\n19 MCP tools across all three Orb Platform products. Works with Claude, Cursor, Windsurf, and any MCP-compatible agent.\n\n## The Orb Platform\n\nWord Orb is one of three products:\n\n| Product | What it does | Scale |\n|---------|-------------|-------|\n| **Word Orb** | Dictionary + translations + pronunciation | 162,251 words, 47 languages |\n| **Lesson Orb** | Structured lesson plans | 226,725 lesson blocks, 5 phases, 10 archetypes |\n| **Quiz Orb** | Assessment questions | 21,900 interactions, 6 question types |\n\nAll three share a knowledge graph with 30,288 connections linking words → lessons → quizzes.\n\n**Education Stack** bundles all three for $179/mo (21% discount).\n\n[Try the playground →](https://word-orb-api.nicoletterankin.workers.dev/playground)\n\n## API Reference\n\n### `new WordOrb(options?)`\n\nCreate a client instance.\n\n| Option    | Type     | Default | Description |\n|-----------|----------|---------|-------------|\n| `apiKey`  | `string` | —       | Your `wo_` API key ([get one free](https://word-orb-api.nicoletterankin.workers.dev/pricing)) |\n| `baseUrl` | `string` | `https://word-orb-api.nicoletterankin.workers.dev` | API base URL |\n\n---\n\n### `orb.word(word)` → `Promise<WordResult>`\n\nLook up any word. Returns definition, pronunciation (IPA), part of speech, etymology, translations across 47 languages, and age-appropriate content.\n\n```js\nconst data = await orb.word('courage');\n// {\n//   word: 'courage',\n//   ipa: '/ˈkɜːrɪdʒ/',\n//   pos: 'noun',\n//   def: 'Courage is the ability to face fear, danger, or difficulty...',\n//   etym: 'From Old French \"corage,\" meaning \"heart, spirit\"...',\n//   langs: { es: 'coraje', fr: 'courage', de: 'Mut', zh: '勇气', ... },\n//   tones: { child: '...', teen: '...', adult: '...' }\n// }\n```\n\n---\n\n### `orb.words()` → `Promise<WordListResult>`\n\nGet the full word library listing.\n\n```js\nconst { count, words } = await orb.words();\nconsole.log(`${count} words available`);\n```\n\n---\n\n### `orb.audit(email, words)` → `Promise<AuditResult>`\n\nRun a compliance audit on your agent's vocabulary. Returns coverage analysis, age-appropriateness gaps, and a compliance grade.\n\n```js\nconst report = await orb.audit('cto@company.com', [\n  'understand', 'help', 'teach', 'learn', 'discover'\n]);\nconsole.log(report.grade);            // 'A-'\nconsole.log(report.compliance_score); // 91\n```\n\n---\n\n### `orb.feedback(word, vote, correction?)` → `Promise<{ ok: boolean }>`\n\nSubmit vocabulary feedback.\n\n```js\nawait orb.feedback('serendipity', 1);                    // upvote\nawait orb.feedback('irregardless', -1, 'Not a word!');   // downvote + correction\n```\n\n---\n\n### `orb.signup(email)` → `Promise<SignupResult>`\n\nCreate a free API key instantly. 50 lookups per day.\n\n```js\nconst { key, tier, daily_limit } = await orb.signup('dev@company.com');\n```\n\n---\n\n### `orb.me()` → `Promise<KeyStatus>`\n\nCheck your API key usage, tier, and remaining calls.\n\n```js\nconst status = await orb.me();\nconsole.log(status.tier);            // 'starter'\nconsole.log(status.remaining_today); // 4873\n```\n\n---\n\n### `orb.health()` → `Promise<HealthResult>`\n\nCheck service health.\n\n```js\nconst health = await orb.health();\n// { status: 'healthy', checks: { kv: 'ok', d1: 'ok (162250 words)', ... } }\n```\n\n---\n\n### `orb.stats()` → `Promise<StatsResult>`\n\nGet database and usage statistics.\n\n## Pricing\n\n| Tier | Price | API Calls/Day | Best For |\n|------|-------|---------------|----------|\n| **Free** | $0 | 50 | Prototyping, evaluation |\n| **Starter** | $49/mo | 5,000 | Side projects, small apps |\n| **Growth** | $149/mo | 50,000 | Production agents, teams |\n| **Enterprise** | $499/mo | Unlimited | Scale, SLA, priority support |\n\n[Get your API key →](https://word-orb-api.nicoletterankin.workers.dev/pricing)\n\n## Error Handling\n\n```js\ntry {\n  const result = await orb.word('nonexistent');\n} catch (err) {\n  if (err.status === 401) console.error('Invalid API key');\n  else if (err.status === 429) console.error('Rate limit reached');\n  else if (err.status === 404) console.error('Word not found');\n  else console.error('API error:', err.message);\n}\n```\n\n## TypeScript\n\nFull TypeScript definitions included:\n\n```ts\nimport { WordOrb, WordResult } from '@lotd/word-orb';\n\nconst orb = new WordOrb({ apiKey: process.env.WORD_ORB_KEY });\nconst result: WordResult = await orb.word('ephemeral');\n```\n\n## Examples\n\nSee the [`examples/`](./examples/) directory:\n\n- **`langchain-tool.js`** — Use Word Orb as a LangChain tool\n- **`crewai-agent.py`** — CrewAI agent with Word Orb vocabulary\n- **`openai-function.js`** — OpenAI function calling integration\n- **`mcp-config.json`** — Claude Desktop MCP configuration\n\n## Links\n\n- [Playground](https://word-orb-api.nicoletterankin.workers.dev/playground) — Try all three products live\n- [Pricing & Signup](https://word-orb-api.nicoletterankin.workers.dev/pricing)\n- [API Docs](https://word-orb-api.nicoletterankin.workers.dev/docs)\n- [MCP Server](https://mcp.thedailylesson.com/mcp) — 19 tools for agent frameworks\n- [npm](https://www.npmjs.com/package/@lotd/word-orb)\n\n## About\n\nBuilt by [Lesson of the Day PBC](https://lotdpbc.com). Language infrastructure for AI agents that need to get words right.\n\n## License\n\nMIT\n",
  "bytes": 7067,
  "sha": "1bd5c9121acc5122e3ce2f2eb29a39a625661e529dd77fb12f6820363b21e7f5",
  "repo_slug": "nicoletterankin/word-orb",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_nicoletterankin_orb_platform_bd2d80c6/readme"
}