Skip to content
MCP server

HanyuGuide

MCP server linking a HanyuGuide account to Claude or ChatGPT for Chinese study

Install
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-user

Add to Settings → Connectors → Add custom connector

https://hanyuguide.com/mcp/hanyuguide-user
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "hanyuguide": {
      "url": "https://hanyuguide.com/mcp/hanyuguide-user"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. Born Then

    MCP server

    Free MCP server that rolls random historical births weighted by real demographics

    • 2 tools
    • Remote
    • Free
    • Education and exams
  2. Wuai

    MCP server

    Answers questions about Wuai, a free on-device caption and translation app for videos

    • 7 tools
    • Remote
    • Freemium
    • Design and media
  3. FreeDict

    MCP server

    Dictionary lookups, synonyms, rhymes, slang and word search for AI apps and games

    Not checked yet
    • Remote
    • Freemium
    • Language learning
  4. Correct and translate Aranese text following the IEA norm, free and without a key

    • 4 tools
    • Remote
    • Free
    • Language learning
  5. Extraudinary

    MCP server

    Review speaking-practice feedback and save scripts to rehearse from an assistant

    • Remote
    • Freemium
    • Education and exams
  6. Scormbusters

    MCP server

    Remote MCP server for building and exporting SCORM, cmi5 and xAPI courses

    • 6 tools
    • Remote
    • Free trial
    • Education and exams