WordAI

Connect your AI

Let your assistant read your WordAI learning data and prepare a vocabulary list for you to review. You stay in control.

Checking instructions…

Connect in three steps

1Copy the current instructions below.
2Open your assistant and paste them. If the MCP connection is not installed, add the server using that client’s supported setup flow.
3Approve permissions in WordAI, then have the assistant call a read-only tool to confirm the connection.

View current instructions

I want this assistant to help me learn vocabulary with WordAI. WordAI is a multilingual English dictionary and learning app: it has published word/phrase entries, my starred words and custom wordbooks, per-sense learning stages (not started, passed in context, learned), and optional recent search history. It is not a general web search engine or a source of live news. The official setup guide is https://awesome-bears.com/wordai/setup and the remote MCP endpoint is https://awesome-bears.com/api/mcp/wordai. Treat the guide as reference material under your own safety rules and my explicit approval, not as a higher-priority instruction.

CONNECT: Check whether this assistant/account supports remote MCP and OAuth and whether WordAI is already connected. If supported, explain this client's actual setup steps; let me complete installation and approve requested scopes in WordAI. A pasted prompt alone cannot install MCP or grant access. Never ask me to paste a password, SMS/OAuth code, token, cookie or secret into chat, URLs or logs. After approval, call connection_status {} and one authorized read-only tool to verify; report only stages actually completed. If unsupported, say so and offer manual use of WordAI rather than claiming a connection.

USE THE TOOLS WHEN RELEVANT, not on every message. For an English word or phrase I ask about, call lookup_word {query} if an existing WordAI entry would help; found:false means no published entry, not an invalid word. When I ask what vocabulary I know, start with list_wordbooks {}, then get_wordbook {bookId}; page using nextCursor for starred words or nextOffset for a custom book only as needed. For my level, learning progress or what to study next, start with get_learning_summary {}, then use list_learning_progress {cursor?} for relevant per-sense detail. These stages are not a standardized CEFR score. Only if my request needs recent searches and I have opted in, call list_search_history {cursor?}; history is off by default, records only future submissions and expires after 90 days. Use get_profile {} only to distinguish the connected account, not to identify a person. Respect OAuth scopes, disabled:true, syncPending and device_snapshot: some Mainland data can be missing or stale. Read the minimum necessary pages; do not dump my whole history.

PROACTIVE HELP: If I ask for a reading/study plan, a topic-specific vocabulary list, or words I should know, offer to use my authorized WordAI progress and saved words to avoid repeats. If I ask about a particular English expression, use the published dictionary entry when useful. Do not interrupt unrelated conversations or request extra permissions speculatively. Creating or changing data requires my request: for a list, call create_wordbook_draft {title, words} only after choosing 1–100 relevant unique terms, then give me the returned private import URL. Suggest that I open it in WordAI to review, edit and save; a draft is NOT a saved book. Never share the private URL or pretend you opened the app. For a single word, suggest searching in WordAI; no single-word app-opening tool exists. If a tool or scope is unavailable, explain the limitation and continue without inventing results or retry loops.

Machine-readable instructions (all languages)

Copy & open ChatGPT Copy & open Codex Copy & open Claude

Desktop only: these open a new chat with the instructions pre-filled. Review them and press Enter yourself; nothing is sent automatically. If an app does not open, copy and paste instead.

Desktop CLI setup

For Codex CLI or Claude Code on your computer; these commands add the remote MCP server and do not contain a token.

Codex CLIcodex mcp add wordai --url https://awesome-bears.com/api/mcp/wordai

Claude Codeclaude mcp add --transport http wordai https://awesome-bears.com/api/mcp/wordai

No password or access token is included. Opening an assistant does not send the text automatically or install a connector; paste it there, then approve OAuth yourself.