browse_library
ChatGPTUse this when the user wants to look through the library themselves: it opens the interactive library, where they can filter by category, theme, age and language, look at a card, play its recordings, collect cards into a set and make a printable. With no arguments it opens on the overview of categories and themes; with a query or filters it opens on the first 24 matching cards. section picks words or phrases (word filters: category, age; phrase filters: theme, routine, speaker, level). Use search_words or search_phrases instead when you only need cards to talk about.
build_activity_set
ChatGPTUse this when the adult explicitly requests a printable, printing or PDF. Choosing cards or artworks for a picture talk is a preview; do not make a printable for that request. Give a title, items ({kind,id} from searches, in order), 1 to 3 languages, layout and optional voice. Layouts: picture-cards (4/page), word-strips (8/page), bilingual-list (20 rows/page), sheet (one card/page with details and credits). Up to 40 existing cards; missing ids fail. Returns cards, page count and a 24-hour printUrl to print or save as PDF. Nothing is stored.
counting_cards
ChatGPTUse this when a parent or educator wants number cards for counting: the numbers 0 to 100, each with its number word and a recording in up to 3 counting voices: en (English), es (Spanish), fr (French), pt (Brazilian Portuguese), de (German), it (Italian), ko-native (Korean — Native), ko-sino (Korean — Sino-Korean), ru (Russian), tl (Tagalog). Give from and to (0 to 100, at most 40 numbers per call) and banks (default ["en"]; English text is always included). Number cards have no picture.
find_resources
ChatGPTUse this when a parent or educator wants guidance or ready-made material beyond the cards: guides (bilingual toddlers, flashcards, late talkers), printables, activities, library pages and FAQs on theirfirstwords.org. Give a topic in a few words, and optionally an app and a kind (guide, printable, activity, faq or library); at least one is required. Returns up to 8 links, best match first, each with its title and a one-line description. Share a link only when it fits what the user is doing.
get_cards
ChatGPTUse this when you know card ids from an earlier search or set and want to preview them again, refresh expired media or change languages. Works for every card kind. Returns up to 40 cards in the given order, with text, pictures and recordings where available, in requested languages plus English. Unknown ids are named in the summary; if none is known the call fails.
letter_cards
ChatGPTUse this when a parent or educator wants alphabet cards: the letters A to Z, each with its sound and recordings of the letter's name and its sound, plus up to 3 example word cards per letter (with pictures and recordings) from the word library, returned in related in letter order. Give letters (default all 26), examples (0 to 3 per letter, default 2) and languages for the example words (up to 3 of en, es, fr, pt, de, it, ko, ru; default en). Letter cards themselves are English.
library_overview
ChatGPTUse this when you need to know what the library holds before searching, or to answer what is in it: it lists the eight languages, the word age groups, the word categories, the phrase themes and the daily routines, each with how many cards it has, and for the other card sources (reading lessons, artworks, place stories, conversation scenes, number cards, letter cards) their counts and filter values: lessons with their sounds, art regions and periods, place kinds and countries, routines and scenes, counting voices and letters. It returns no cards. Every word and phrase card has a picture and recordings in a female and a male voice.
list_ready_sets
ChatGPTUse this when the user wants something ready to print without choosing cards one by one: 18 hand-picked word and phrase sets by routine and age (animals, body, mealtime, bath, bedtime, dressing, feelings, colors, playground, preschool, outside). Returns set ids, descriptions, age, routine or category and card counts. Call ready_set with preview:true to view cards; omit preview only for explicit printing.
ready_set
ChatGPTUse this when the adult wants a ready-made set (ids from list_ready_sets). Set preview:true to view its cards without a printable. Only omit preview when the adult explicitly asks to print: returns a 24-hour printUrl. Languages and layout are optional.
search_artworks
ChatGPTUse this when a parent or educator wants real artworks to look at and talk about with a child, or pictures of cities and nature from around the world: 100 artworks from the ancient world to 1930, each with its title, artist, date, place and museum, and 100 place pictures. Give at least one of query (a title, artist or place), region, period or country; kind picks artworks (default), place pictures or both (region and period describe artworks only). Results are oldest first, up to 24 per call (default 12), with offset for the next ones. Each card has a picture, an English recording and a credit line (meta.credit): show the credit with the picture. Preview picture talks; only make a printable if explicitly requested.
search_conversations
ChatGPTUse this when a parent or educator wants the lines of an everyday scene to act out or read together, such as a good-morning, mealtime or bedtime conversation: 60 scenes in 7 routines, each with a picture and short lines at two levels (Little Kid and Big Kid), in English, Spanish and Korean, every line with a recording. Give at least one of routine, scene (its id or title) or query (words in a line or a title); level picks one level; languages picks up to 3 of en, es, ko (default en; English is always included). Returns whole scenes, every line in order, up to 8 scenes (limit, default 3), and the scenes matched.
search_phrases
ChatGPTUse this when a parent or educator wants phrase cards: short everyday sentences a young child or a caregiver says, such as "I want water." or "Do you want help?", each with a picture and recordings. Give at least one of query, theme, routine (mealtime, bedtime, playground and so on), speaker or level; a call with none is refused, because the library is never listed whole. The query matches any of the eight library languages, ignoring Latin accents and capitals. Returns up to 24 cards (default 12), how many matched in total, and counts by theme and routine. Each card has its text in each requested language plus English, a picture link, and recording links for each language in a female (f) and a male (m) voice. Card ids feed get_cards and build_activity_set.
search_places
ChatGPTUse this when a parent or educator wants a place's story and facts for a short talk or a place sheet: 271 cities and landmarks around the world, each with a short intro, a story, facts and sources in one of 11 languages (en, es, fr, de, it, pt, ru, ko, ja, zh, tl). Give a query (a place's name in any of those languages) or a country (its name in any of them, or its id), and optionally kind (city or landmark) and language (default en). Returns up to 12 places (default 6) with the name in English and the chosen language; places have no picture or recording.
search_reading
ChatGPTUse this when a parent or educator wants decodable words and sentences for a phonics lesson: 914 words and 343 sentences across 142 lessons in 7 stages, each lesson teaching one sound or spelling. Give at least one of lesson (a number from 1 to 142, or its id), sound (such as "sh", "a_e" or "igh"), stage (1 to 7) or query; kind picks words, sentences or both (default). Returns up to 24 cards (default 12) in lesson order, and the lessons matched with their sound, title and counts. Reading cards are English text with an English recording (most cards) and no picture.
search_words
ChatGPTUse this when a parent or educator wants word cards: single words such as "dog", "spoon" or "happy", each with a picture and recordings. Give at least one of query, category or age; a call with none is refused, because the library is never listed whole. The query matches any of the eight library languages, ignoring Latin accents and capitals: "perro" finds dog even with English selected. Returns up to 24 cards (default 12), how many matched in total, and counts by category and age. Each card has its text in each requested language plus English, a picture link, and recording links for each language in a female (f) and a male (m) voice. For the Korean words for brother and sister the word depends on who is speaking: textsByVoice gives the word that matches each voice's recording. Card ids feed get_cards and build_activity_set.
ui_search
ChatGPTUse this when the library view needs a page of cards for its grid: section words, phrases, reading, artworks, places, conversations, counting, letters, with that section's filters (the same inputs as search_words, search_phrases, search_reading, search_artworks, search_places, search_conversations, counting_cards, letter_cards). Up to 60 cards per call (24 places, 8 conversation scenes), with offset and nextOffset for the next page. The section's own rule for a required filter applies.
ui_set_preview
ChatGPTUse this when the library view needs to preview a set before it is made printable: the same input as build_activity_set (title optional), returns the set's cards and page count with an empty printUrl.