Lingard

Search Lingard Vocab

Use this when the user asks about their Lingard vocabulary, learning context, English profile, totals, collection titles, saved words, flashcards, or missing vocabulary fields. Returns live Lingard Firestore results; do not use generic memory or personal context instead.

Fetch Lingard Vocab Record

Use this after search, or when the user gives a Lingard resource URI such as lingard://learning-context/en. Fetches the full live Lingard JSON record from Firestore.

Get Lingard Learning Context

Call this first whenever the user asks for their current Lingard learning context, English profile, vocabulary totals, saved collections, collection titles, card counts, or missing-field stats. Reads live Lingard Firestore data; do not answer from memory or generic Lingard history. Every collection reports `source`: "user" (made by the user), "catalog" (a curated Lingard collection — read-only, its words come from the Lingard catalog) and "unfiled" (the bucket of cards saved while reading, which

Get Lingard Vocabulary Collection

Returns live cards from one Lingard vocabulary collection by UUID or title, including curated Lingard collections and the "Words not in a collection" bucket of cards saved while reading. Use this when the user asks what words/cards are in a specific Lingard collection. Pass includeExamples:true to also read each card's example sentences and their translations — required before editing them.

Get Lingard Collection Gaps

Returns live Lingard cards in a collection that are missing requested fields such as translation, POS, pronunciation, examples, or image. Use before filling missing fields. A curated Lingard collection always reports zero gaps: its words come from the Lingard catalog and are not the user's to fill.

Get Lingard Word Suggestion Context

Returns live Lingard profile level, topic, collection context, and existing words so the calling AI can suggest level-appropriate new cards without duplicates.

Preview Lingard Vocabulary Changes

Previews a Lingard vocabulary collection/card change without writing to Firestore. For AI-generated new cards, include all applicable useful fields except image by default: title, translate, pos, pron/ipa, syns, and examples with translations. For German/Romance nouns, include the dictionary article in title/word when needed, e.g. der Hund, die Reise, das Haus. Example text and example translation must highlight the target word/translated word with {}. form is not part of speech; use it only for

Commit Lingard Vocabulary Changes

Commits a previously previewed or freshly supplied Lingard vocabulary change. For AI-generated new cards, include all applicable useful fields except image by default: title, translate, pos, pron/ipa, syns, and examples with translations. For German/Romance nouns, include the dictionary article in title/word when needed, e.g. der Hund, die Reise, das Haus. Example text and example translation must highlight the target word/translated word with {}. form is not part of speech; use it only for the

Create Lingard Vocabulary Collection

Creates a Lingard vocabulary collection, optionally with initial cards. Pass commit=true to write. By default every AI-generated card must include all applicable useful fields except image: title, translate, pos, pron/ipa, syns, and examples with translations. For German/Romance nouns, include the dictionary article in title/word when needed, e.g. der Hund, die Reise, das Haus. Example text and example translation must highlight the target word/translated word with {}. form is not part of speech

Add Lingard Words To Collection

Adds cards to an existing Lingard collection, deduplicating by normalized word title. Pass commit=true to write. Only collections with writable="full" accept new cards: curated Lingard collections are read-only and the unfiled bucket takes no new cards — create a collection with lingard_create_vocab_collection instead. By default every AI-generated card must include all applicable useful fields except image: title, translate, pos, pron/ipa, syns, and examples with translations. For German/Romanc

Fill Missing Lingard Card Fields

Fills empty fields on existing Lingard cards. It never overwrites non-empty fields, except a card may use clearFields:["form"] to clear an incorrect grammatical form when the word is base/unmarked. Works on the user's own collections and on the "Words not in a collection" bucket; curated Lingard collections are read-only because their content comes from the Lingard catalog. Pass commit=true to write.

Update Lingard Example Translations

Rewrites only the translation line of examples that already exist on Lingard cards; the example sentence, its {} highlights and its audio/typing markers are left exactly as they are. Use this when the user wants to change, add, or remove example translations — including leaving them empty, which is a supported card state, not an error. Read the current examples first with lingard_get_vocab_collection includeExamples:true, then send one `translations` entry per example, in order. Pass commit=true

Attach Lingard Card Images

Attaches generated or supplied images to existing Lingard cards. This tool does not generate images from prompt alone: pass actual imageBase64, dataUri, or imageUrl. PNG, JPEG, WebP, and SVG inputs are converted to WebP and uploaded as private custom card images. Pass commit=true to write.