Get Word List by Topic (One Call)
get_word_listGet a word list in one call from a plain topic, without needing the dataset slug: topic (for example "sight words", "CVC", "digraph", "Spanish syllables", "animals"), optional level, optional count, optional offset. The lists are the standard published classroom lists served exactly as published (Dolch sight words and nouns, CVC families, digraph words, Spanish syllables, Turkish-English pairs). The core Turkish-English sets (early words, colors, everyday objects) also include one simple example sentence per pair in English and Turkish. Grade-1 Dolch words also carry a short carrier phrase each in a carrier_phrases map. Use when you need a ready-to-use list of words for a lesson, worksheet, quiz, or flashcard set and do not already hold a dataset slug. Do not use when you need an interactive activity or tool metadata - use search_classroom_tools or get_classroom_tool instead. Behavior: read-only, idempotent, no authentication; returns count items starting at offset (default 0) in canonical order when count is given, otherwise the full filtered list from offset, identical on every repeat, with a SHA-256 content_hash of the full dataset. The response carries offset, total_count, and has_more so a caller can fetch the next batch statelessly; an offset past the end of the list returns an empty list with has_more false, never an error. An unknown topic or a level foreign to the matched dataset returns error -32602 with no partial results.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"topic": "<topic>"
},
"name": "get_word_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | Optional maximum number of items to return, taken from the start of the canonical order; omit to return the full filtered list | |
| level | No | Optional level or family within the matched dataset, same values as get_curriculum_dataset level_or_family (Dolch levels pre-primer, primer, grade-1, grade-2, grade-3; CVC rimes such as -at; digraphs sh, ch, th, wh; Spanish syllables or words). Omit for datasets without subsets | |
| topic | Yes | Plain topic phrase, for example sight words, Dolch nouns, CVC, digraph, Spanish syllables, animals, colors, objects, Turkish early words; an exact dataset slug is also accepted | |
| offset | No | Optional number of items to skip from the start of the canonical order, for fetching the next batch statelessly (for example count=10, offset=10 returns items 11-20); default 0; an offset past the end returns an empty list with has_more false |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | Present only when offset is past the end of the list | |
| items | Yes | The returned items in canonical order; element shape depends on the dataset (see get_curriculum_dataset) | |
| offset | No | Number of items skipped from the start of the canonical order | |
| creator | Yes | Dataset creator, always Birkan Yavuz | |
| has_more | No | Whether more items remain after this batch | |
| dataset_id | Yes | Stable dataset id in the form birkanyavuz:<name>:v1 | |
| item_count | Yes | Number of items in this response after count and offset limiting | |
| total_count | Yes | Number of items in the filtered list before count and offset limiting | |
| content_hash | No | SHA-256 of the full unfiltered dataset; changes only when the data changes | |
| resource_uri | No | Stable edu:// URI for this dataset | |
| invocation_id | Yes | Unique receipt id for this call | |
| record_digest | No | One-line citation naming the dataset, creator and endpoint | |
| carrier_phrases | No | Present only for Dolch grade-1 words: each returned grade-1 word mapped to its short carrier phrase |