add_word_to_study_list
ChatGPTSave 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
ChatGPTAdd 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
ChatGPTFetch public single-character decomposition, readings, radical, stroke order paths, and stroke medians when HanyuGuide has them.
dictionary_entries
ChatGPTLook 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
ChatGPTFetch a public HanyuGuide dictionary entry with definitions, variants, relations, usage notes, examples, and character metadata when present.
dictionary_search
ChatGPTSearch public Chinese dictionary entries by Hanzi, pinyin, or English meaning.
difficult_words
ChatGPTReturn words the authenticated learner currently finds difficult, based on spaced-repetition state.
hsk_quiz_words
ChatGPTPick 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
ChatGPTCreate, 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
ChatGPTMove 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
ChatGPTConvert Chinese text to tone-mark pinyin using HanyuGuide dictionary-backed longest-match segmentation.
recently_studied_words
ChatGPTReturn the authenticated learner's recent HanyuGuide study words for targeted practice.
record_reviews
ChatGPTSave 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
ChatGPTRemove 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
ChatGPTPlace 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
ChatGPTAsk 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
ChatGPTReturn a deduplicated mix of recent and difficult words suitable for generating a short learner-specific story.
study_list_words
ChatGPTRead 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
ChatGPTList 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
ChatGPTStart 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
ChatGPTReturn compact aggregate study context for the authenticated learner.
add_word_to_study_list
Claudeadd_words_to_study_lists
Claudecharacter_strokes
Claudedictionary_entries
Claudedictionary_entry
Claudedictionary_search
Claudedifficult_words
Claudehsk_quiz_words
Claudemanage_study_lists
Claudemove_study_list_words
Claudepinyin_convert
Clauderecently_studied_words
Clauderemove_words_from_study_lists
Claudereorder_study_lists
Claudestory_seed_words
Claudestudy_list_words
Claudestudy_lists
Claudestudy_summary
Claude