How to Add 47 Languages to Your AI Agent in 5 Minutes
Your AI agent speaks English. Congratulations. So does every other agent on the market.
The agents that win enterprise contracts, land international users, and actually ship to production are the ones that greet a customer in Swahili, teach a child in Mandarin, or guide a warehouse worker in Portuguese. Language breadth is not a feature request on the backlog. It is a deployment requirement.
Word Orb provides curated vocabulary across 47 languages through a single API. Every entry includes IPA pronunciation, etymology, cultural context, and gender-aware example sentences. The content is powered by Kelly, our AI teaching companion, and maintained by linguists rather than scraped from the open web.
Here are three ways to integrate it, each taking less than five minutes.
Method 1: REST API
The fastest path. One HTTP call returns structured lesson content for any supported language.
curl
curl -X GET "https://api.wordorb.ai/api/word-of-the-day?lang=es" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"
Every response includes IPA transcription, grammatical gender where the language requires it, and cultural context that a web scraper would never capture.
Python
import requests
API_KEY = "YOUR_API_KEY"
BASE_URL = "https://api.wordorb.ai/api"
def get_daily_lesson(lang="fr"):
response = requests.get(
f"{BASE_URL}/word-of-the-day",
params={"lang": lang},
headers={"Authorization": f"Bearer {API_KEY}"}
)
return response.json()
lesson = get_daily_lesson("fr")
print(f"{lesson['word']} ({lesson['ipa']}) - {lesson['translation']}")
JavaScript / Node.js
const API_KEY = "YOUR_API_KEY";
async function getDailyLesson(lang = "ja") {
const res = await fetch(
`https://api.wordorb.ai/api/word-of-the-day?lang=${lang}`,
{ headers: { Authorization: `Bearer ${API_KEY}` } }
);
return res.json();
}
const lesson = await getDailyLesson("ja");
console.log(`${lesson.word} (${lesson.ipa}) - ${lesson.translation}`);
Method 2: npm SDK
npm install @lotd/word-orb
import { WordOrb } from "@lotd/word-orb";
const orb = new WordOrb({ apiKey: process.env.WORDORB_API_KEY });
const lesson = await orb.getWordOfTheDay({ lang: "ko" });
console.log(lesson.word); // structured response
console.log(lesson.ipa); // IPA pronunciation
console.log(lesson.etymology); // etymology
The SDK handles retries, response validation, and rate limit awareness so your agent does not make redundant network calls during a conversation.
Method 3: MCP Server (Claude, Cursor, Windsurf)
If your agent runs inside an MCP-compatible host, you can add Word Orb as a tool server with zero code.
Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"wordorb": {
"command": "npx",
"args": ["-y", "@lotd/word-orb-mcp"],
"env": { "WORDORB_API_KEY": "YOUR_API_KEY" }
}
}
}
Once configured, your agent gains access to tools like get_daily_lesson, get_languages, and get_word_audio. No SDK installation, no fetch calls, no parsing.
What Makes This Different
Curated by linguists. Every entry is reviewed by native speakers. No auto-translated filler.
Gender-aware. Languages with grammatical gender include full gender metadata. Example sentences rotate between masculine, feminine, and neutral constructions.
IPA pronunciation included. Every word ships with International Phonetic Alphabet transcription.
Etymology and cultural context. Your agent does not just know the word. It knows where the word came from and when to use it appropriately.
API keys are available immediately at wordorb.ai/pricing. The free tier includes 50 requests per day. Your agent already thinks. Give it something worth saying.