learner_get_allowed_vocabulary
ChatGPTPage through a saved generation request's allowed wordforms, up to 500 per page.
By CTO Teachings LLC
Use your LangLearn vocabulary to create stories, conversations, and audio lessons, then save them to your LangLearn library. Browse your existing passages and retrieve the word lists and learning rules for your selected language. Requires a LangLearn account with a learning language configured. This connection provides learner tools; administrative language and course authoring are unavailable. Generated content is validated by LangLearn and can be rejected when it does not meet the learning rules.
dryRun: true to run every check without storing anything; the answer is ok plus findings. Fix every finding and repeat until ok is true, then send the same lesson without dryRun. Before that, have a validation subagent check that every line is natural. THE CONTENT (lesson): sentences — the conversation, in the language being learned, no word twice in one sentence. How many is the BAND's: up to 12, and from the middle of a course a lesson runs 9 to 12. Write the number the conversation needs, not the minimum — the extra sentences exist so the words you owe have somewhere natural to go. hookLines — 2 to 4 lines of the mini-conversation the lesson opens and closes on, each made of whole sentences, and no line starting with all the words of the line before it (merge such lines into one); wordformsToLearn — the wordforms the lesson teaches, one entry each as {wordform, translation}, every wordform ONE word said whole by a sentence and spelled exactly as that sentence spells it, and translation its meaning in my first language; reviewWordforms — earlier words to ask for again; syllables — for every word of every taught wordform, {"parts": [...]} whose parts join back into the word (English also needs phonemes, one IPA entry per part); meanings — my first-language meaning of every review wordform and whole sentence (a taught wordform's meaning rides on its own entry, not here); situations — each sentence's one-line scene ("You bump into a friend in the street."); cues — for each sentence, the question that asks for it ("How do you say: hi?"); rolePlay — 2 to 4 {cue, sentence} scene cues ("A friend waves at you. Say hi."); framing — hookIntro ("Listen. By the end of this lesson you'll be able to say this."), sentenceIntro ("Listen to this sentence."), meaningIntro ("It means:"), walkIntro ("Listen and repeat."; it may use {sentence} for the sentence number and {index} for the word the build-up starts at, e.g. "Sentence {sentence}. Listen and repeat.", and never a digit), learnIntro ("Let us learn how to say '{meaning}'" — it must carry {meaning} exactly once), syllableIntro ("Repeat these syllables"), repeatIntro ("Repeat after me" — opens the drill of a one-syllable word), meaningQuestion ("What does {word} mean?" — it must carry {word} exactly once), reviewIntro and dialogueAgain ("Listen to the conversation again."), all in my first language; optionally introProse and names. WHAT THE SERVER BUILDS: the hook; for each sentence with a new wordform, its scene, the sentence, "It means: …", "Listen and repeat.", a syllable drill for each new word of two or more syllables, chunks built from the END (each said twice, the second slowed), and a cue asking for it, then the cue of the previous sentence for you to say again; then "what does it mean?" for every new word and every sentence; then a review that asks for every word and every sentence once and plays the role-play cues; the hook again. Keep meanings, scenes and cues short. THE BANDS. A course lesson gets its band from …toLearnLang half is filed as my story and is checked 100% against the word rules below. The firstLang half is NOT checked against anybody's level: it is re-tokenized and RATED, then filed as a real story in the firstLang catalogue for people learning THAT language from mine. A hard firstLang sentence is never a rejection — it just rates that story higher and serves a more advanced reader. So write the firstLang half as natural prose, not as a word-for-word crib. THE SHAPE. A story is a LIST OF SENTENCES, not a blob of text. Each entry carries one toLearnText and the same sentence as firstLangText — I read them stacked, one under the other, so a firstLang line covering two sentences at once lands under the wrong one. BOTH LANGUAGES ARE NAMED, ALWAYS. toLearnLang and firstLang are both REQUIRED and neither is guessed from my settings — an upload files a story in EACH of them, so each one has to be chosen rather than inferred. ONE KIND OF STORY, IN ONE OF TWO MODES. Every upload sends maxWordRank (with requirementsId it must EQUAL the saved request's Max Word Rank; otherwise use what I asked for or learner_get_wordform_lists.defaultMaxWordRank). With a requirementsId, FIRST call learner_get_wordform_lists with that same requirementsId: its requestWords are the words I asked for, and you write from them. EVERY RULE BELOW IS THE SAVED REQUEST'S — read its values from learner_get_wordform_lists (oneNewWordPerSentence, the rangeWordsPercent minimum, firstLessonsWordsKnown, minWords/maxWords). With a requirementsId, leave out minWordRank, minWords, maxWords and requiredWords — they are the saved request's; a different value is refused. Then exactly one mode: RANGE (the default): the range words (minWordRank..maxWordRank) are the NEW words; every word below minWordRank is free to use. Every word is ranked at or below Max. Meet or exceed the saved minimum % of story words that are range words (default 7%; 20% is only the highest configurable minimum, not an actual-content ceiling): validation credits each DIFFERENT range wordform once, divided by ordinary ranked story-word occurrences. Declared names/places do not count; repeating one word earns no extra credit. You pick WHICH range words to use — you need not use them all. A rejection says exactly how many different range wordforms to add. Without requirementsId send BOTH minWordRank and maxWordRank, each at least 200, at most 50 apart. REQUIRED WORDS: only the required words are new; every other word is ranked at or below maxWordRank. Every listed word appears (with oneNewWordPerSentence: at most one per sentence). With requirementsId the list is the saved request's; outside the browser send requiredWords (1-10 words, never together with minWordRank). NAMES AND PLACES. Use the language's names and places: learner_get_wordform_lists.suggestedNames (10 names + 10 places), as many as the story needs — there is no cap. Mark a person's name with kind "name" and a place with kind "place" in toLearnTokens. A person must be one of those names. A declared name/place never sets the story's level and never counts toward the range-word percentage; a declared word that is NOT one of them still obeys maxWordRank. CONVERSATIONS. When the saved request (requirementsId) is a CONVERSATION, the story is two people talking: send speakers — EXACTLY two, each {toLearnName, firstLangName} — and give EVERY sen…Click any prompt to copy it.
Add this badge to your site or README. It links to this page.
HTML
<a href="https://mcp-app-store.keenethics-labs.com/app/langlearn"><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
[](https://mcp-app-store.keenethics-labs.com/app/langlearn)