MCP App Store
by KeenEthics
HanyuGuide icon

HanyuGuide MCP Server for Claude and ChatGPT

By HanyuGuide

Overview

Sign in with a HanyuGuide account to get quizzed on random words from any HSK 2.0 or HSK 3.0 level, look up Chinese words, convert text to tone-mark pinyin, and inspect character stroke data, with definitions in your language. Each quiz links to HSK flashcard practice on HanyuGuide. The same account lets the assistant read your study context and personal lists. With separate permissions, add words in bulk, move or remove words, and create, rename, reorder, archive, or restore personal lists. These tools cannot change study progress, preferences, or billing.

How to connect

  1. Claude: Open the HanyuGuide listing in the Claude connectors directory and choose Connect. Claude listing HanyuGuide exposes 18 tools here.
  2. ChatGPT: Open the HanyuGuide listing in the ChatGPT app directory and choose Connect. ChatGPT listing HanyuGuide exposes 21 tools here.

Tools

add_word_to_study_list

ChatGPT
Save one dictionary word to a chosen personal list. For multiple words or lists, use add_words_to_study_lists instead. Never invent IDs. Repeating a save is safe.

add_words_to_study_lists

ChatGPT
Add dictionary words to multiple chosen personal lists in one request. Prefer this tool over repeated single saves. Discover list and word IDs first. Repeating a batch is safe; existing words and study progress are preserved.

character_strokes

ChatGPT
Fetch public single-character decomposition, readings, radical, stroke order paths, and stroke medians when HanyuGuide has them.

dictionary_entries

ChatGPT
Look up up to 20 Chinese words per request. Prefer this bulk lookup to repeated dictionary_entry calls when preparing flashcards. Returns dictionary IDs and a found, not_found, or duplicate (already returned in this request) status for each input.

dictionary_entry

ChatGPT
Fetch a public HanyuGuide dictionary entry with definitions, variants, relations, usage notes, examples, and character metadata when present.

difficult_words

ChatGPT
Return words the authenticated learner currently finds difficult, based on spaced-repetition state.

hsk_quiz_words

ChatGPT
Pick a random set of official HSK words from one level to quiz the learner. Each word has pinyin, its definition, and three wrong-answer definitions from the same level for multiple choice. HSK 2.0 has levels 1-6; HSK 3.0 has levels 1-7, where 7 means the combined 7-9 band. Call again for a fresh set. Quiz one word at a time and keep the answer hidden until the learner responds. Results include a flashcard link for that level.

manage_study_lists

ChatGPT
Create, rename, archive, or restore up to 20 personal lists atomically. Archiving is reversible. For create, an active personal list with the same exact name is reused to make retries safe. Discover archived IDs with study_lists include_archived. Only perform changes the learner requests.

move_study_list_words

ChatGPT
Move up to 200 words between two personal lists atomically, preserving source annotations and cloze cards. Retries are safe. Conflicting annotations reject the entire batch. Use only when the learner requests a move.

pinyin_convert

ChatGPT
Convert Chinese text to tone-mark pinyin using HanyuGuide dictionary-backed longest-match segmentation.

recently_studied_words

ChatGPT
Return the authenticated learner's recent HanyuGuide study words for targeted practice.

record_reviews

ChatGPT
Save the learner's answers to HanyuGuide flashcards studied in the conversation, so they count in HanyuGuide like answers given in the app and schedule each word's next review. Only for words from study_session or words the learner already studies. Set remembered from what the learner actually answered: true only when they recalled the meaning, false when they got it wrong, gave up, or asked for the answer. Never guess an answer for the learner. The flashcard card saves its own answers, so do not save those again.

remove_words_from_study_lists

ChatGPT
Remove word memberships from personal lists in bulk, only when requested. Does not delete dictionary words or study progress. Repeating a batch is safe.

reorder_study_lists

ChatGPT
Place up to 100 active personal lists in the requested relative order. Omitted lists retain their positions. Supply list IDs from study_lists. Repeating the same ordering is safe.

request_word

ChatGPT
Ask the HanyuGuide team to add a Chinese word the dictionary does not have yet. Use only after dictionary_entry or dictionary_search came back empty for it, and only when the learner wants it. Put what the learner knows in details: the meaning they think it has and where they saw it. With list_id (from study_lists), the word goes into that personal list once it is added; that needs list permission and full study access. The learner gets an email when the word is in.

story_seed_words

ChatGPT
Return a deduplicated mix of recent and difficult words suitable for generating a short learner-specific story.

study_list_words

ChatGPT
Read word IDs, Chinese text, and pinyin from up to 10 personal lists at once, including archived lists. Each list has its own stable word-ID cursor. Use these IDs for bulk moves and removals; never infer IDs.

study_lists

ChatGPT
List the authenticated learner’s personal lists, in stable ID pagination order. Use position to reconstruct display order. Use the returned IDs when the learner asks to save a dictionary word. Never infer a list ID.

study_session

ChatGPT
Start a HanyuGuide study round for the signed-in learner as flashcards in the conversation: their due reviews first, then new words from their study lists up to today's goal, the same round the HanyuGuide app would give them. Use when the learner wants to study, review, or learn new words here. Where the flashcard card shows, the learner answers on the card and the card saves each answer; do not repeat the words as a text quiz. Without the card, show one word at a time with the meaning hidden (for a new word, show its meaning first), let the learner answer, then save the answers with record_reviews. On subscription_required, tell the learner their free session is over and share upgrade_url.

study_summary

ChatGPT
Return compact aggregate study context for the authenticated learner.

add_word_to_study_list

Claude

add_words_to_study_lists

Claude

character_strokes

Claude

dictionary_entries

Claude

dictionary_entry

Claude

difficult_words

Claude

hsk_quiz_words

Claude

manage_study_lists

Claude

move_study_list_words

Claude

pinyin_convert

Claude

recently_studied_words

Claude

remove_words_from_study_lists

Claude

reorder_study_lists

Claude

story_seed_words

Claude

study_list_words

Claude

study_lists

Claude

study_summary

Claude

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/hanyuguide"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/hanyuguide)