Documentation

Word Orb provides complete word intelligence for AI agents via REST API and MCP (Model Context Protocol).

Quick Start

REST API

curl https://api.wordorb.ai/word/serendipity

MCP Configuration

Add to your MCP client (Cursor, Claude Desktop, etc.):

{
  "mcpServers": {
    "word-orb": {
      "url": "https://mcp.wordorb.ai/mcp",
      "transport": "streamable-http"
    }
  }
}

REST API Reference

Base URL: https://api.wordorb.ai

GET /word/:word

Full word enrichment — definition, IPA, etymology, Kelly’s insight, translations, tones, connections.

GET /word/:word/ethics

Ethical language guidance — gender context, inclusive alternatives, agent communication tips.

GET /agent/speak?intent=:intent&audience=:audience

Agent communication guidance. Audience: one_person, few_people, many_people.

GET /stats

Vocabulary count, lesson count, and top looked-up words.

MCP Tools

The MCP endpoint at https://mcp.wordorb.ai/mcp exposes 8 tools via JSON-RPC 2.0:

Tool	Description
`word_enrich`	Complete pedagogical word object
`word_translate`	Translations in up to 8 languages
`word_connections`	Semantic knowledge graph traversal
`word_search`	Search by prefix, POS, or keyword
`word_batch`	Batch enrichment (up to 20 words)
`lesson_of_day`	Daily lesson segments (365 days × 11 langs × 3 ages)
`word_ethics`	Ethical language guidance
`agent_speak`	Agent communication phrasing

MCP Example Request

POST https://mcp.wordorb.ai/mcp
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "word_enrich",
    "arguments": { "word": "serendipity" }
  }
}

Rate Limits

Tier	Daily Limit	Price
Free	50 calls	$0/mo
Starter	5,000 calls	$49/mo
Growth	50,000 calls	$149/mo
Enterprise	Unlimited	$499/mo

Domains

Domain	Purpose
`wordorb.ai`	Landing page & product info
`api.wordorb.ai`	REST API (clean URLs without /api prefix)
`mcp.wordorb.ai`	MCP endpoint (JSON-RPC 2.0)
`docs.wordorb.ai`	This documentation
`voices.wordorb.ai`	Voice agent previews

Legacy endpoint mcp.thedailylesson.com remains fully operational.