HanyuGuide
MCP server linking a HanyuGuide account to Claude or ChatGPT for Chinese study
- Pricing
- Freemium
- Platforms
- Web, API
- Runs
- Remotely
- Version
- 0.6.3
- Listing updated
- 1 day ago
About HanyuGuide
HanyuGuide is a freemium MCP server for language learning. It runs as a hosted remote server, so there is nothing to install locally.
HanyuGuide is a Chinese learning service, and this connector gives an assistant its dictionary and your own study record. Because the assistant can see which words you studied recently and which you keep getting wrong, it can write a story or dialogue from your vocabulary, quiz you on weak words, or run your flashcard reviews in the chat, with answers counted in the app.
The dictionary tools are free with any account and cover search by characters, pinyin or English, full entries, batch lookups of up to 20 words, tone-marked pinyin, stroke order and random HSK quiz words. List tools create, rename, reorder, archive and restore personal lists and add, move or remove words. Teachers can photograph a worksheet and have it matched to dictionary entries and saved as a list.
List edits need full study access and list permission. The site says no tool can change settings or billing or permanently delete a list. Flashcard sessions are free the first time, then need a plan; subscription prices are in Australian dollars.
Install
Run in a terminal
claude mcp add --transport http hanyuguide https://hanyuguide.com/mcp/hanyuguide-userAdd to Settings → Connectors → Add custom connector
https://hanyuguide.com/mcp/hanyuguide-userAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"hanyuguide": {
"url": "https://hanyuguide.com/mcp/hanyuguide-user"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"hanyuguide": {
"type": "http",
"url": "https://hanyuguide.com/mcp/hanyuguide-user"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"hanyuguide": {
"serverUrl": "https://hanyuguide.com/mcp/hanyuguide-user"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"hanyuguide": {
"type": "http",
"url": "https://hanyuguide.com/mcp/hanyuguide-user"
}
}
}Tools this server provides (21)
Taken from the project documentation; the running server may differ.
- study_session
- Your due reviews, then new words from your lists, as flashcards in the chat.
- record_reviews
- Save your answers so each word's next review is scheduled.
- dictionary_search
- Find words by characters, pinyin, or English meaning.
- dictionary_entry
- Meanings, readings, examples, and related words for one word.
- dictionary_entries
- Look up to 20 words at once.
- pinyin_convert
- Add tone-mark pinyin to Chinese text.
- character_strokes
- How a character is built and the order of its strokes.
- hsk_quiz_words
- Random official HSK words with answer choices for a quiz.
- recently_studied_words
- The words you studied most recently.
- difficult_words
- The words you keep getting wrong in reviews.
- study_summary
- Words studied, reviews this week, and reviews due now.
- story_seed_words
- A mix of recent and difficult words for a story or dialogue.
- study_lists
- Your personal study lists.
- study_list_words
- The words in your personal lists.
- request_word
- Ask to add a word the dictionary is missing.
- add_words_to_study_lists
- Add dictionary words to one or more lists.
- add_word_to_study_list
- Add one word to one list.
- remove_words_from_study_lists
- Remove words from lists.
- move_study_list_words
- Move words from one list to another.
- manage_study_lists
- Create, rename, archive, or restore lists.
- reorder_study_lists
- Change the order of your lists.
What it does
- Dictionary lookups
- Search, look up entries, convert pinyin and see stroke order.
- Study-aware practice
- Uses recent and difficult words to write stories, dialogues and quizzes.
- Flashcard sessions
- Runs due reviews in chat and records answers for scheduling.
- List management
- Create, rename, reorder, archive and restore lists and move words.
- Worksheet to list
- Turns a photographed textbook page into a saved vocabulary list.
- Safe limits
- No tool can change billing or permanently delete a list.
Good for
- Quiz yourself on words you keep missing
- Generate a short story using your current vocabulary
- Build a class vocabulary list from a worksheet photo
- Look up stroke order or tone-marked pinyin
Pricing
Freemium
Dictionary free with an account; study plans A$12.99/month, A$64.99/year or A$159 one-time
Prices change. Check hanyuguide.com before you buy.
HanyuGuide FAQ
Do I need an account?
Yes, a HanyuGuide account is needed; creating one is free.
What costs money?
Flashcard studying after the first free session needs a plan; dictionary tools are free.
What are the plans?
Yearly A$64.99, monthly A$12.99 or a one-time Unlimited Access at A$159.
Which assistants are supported?
Claude, through its connector directory, and ChatGPT as a plugin.
Is HanyuGuide free?
HanyuGuide has a free plan, with paid plans for more usage or features.
How do I add HanyuGuide to Claude Code?
Run this command in your terminal: claude mcp add --transport http hanyuguide https://hanyuguide.com/mcp/hanyuguide-user
What are the best alternatives to HanyuGuide?
The closest alternatives to HanyuGuide are Born Then, Wuai, FreeDict, A punt · Aranese (Val d'Aran Occitan) and Extraudinary.
Alternatives to HanyuGuide
Born Then
MCP serverFree MCP server that rolls random historical births weighted by real demographics
- 2 tools
- Remote
- Free
- Education and exams

Wuai
MCP serverAnswers questions about Wuai, a free on-device caption and translation app for videos
- 7 tools
- Remote
- Freemium
- Design and media

FreeDict
MCP serverDictionary lookups, synonyms, rhymes, slang and word search for AI apps and games
Not checked yet- Remote
- Freemium
- Language learning

A punt · Aranese (Val d'Aran Occitan)
MCP serverCorrect and translate Aranese text following the IEA norm, free and without a key
- 4 tools
- Remote
- Free
- Language learning

Extraudinary
MCP serverReview speaking-practice feedback and save scripts to rehearse from an assistant
- Remote
- Freemium
- Education and exams

Scormbusters
MCP serverRemote MCP server for building and exporting SCORM, cmi5 and xAPI courses
- 6 tools
- Remote
- Free trial
- Education and exams