Find lecture clips to teach a topic
search_teaching_clipsFinds the few minutes inside real lectures where a teacher explains a topic, for a teacher planning a class, by the topic's name and the class's Level. Typical requests it serves: "a few minutes of a lecture on the chain rule for my Grade 12 class", "a concrete example of entropy for first-year chemistry". Example: the chain rule returns MIT 18.01 Lecture 04 from 28:03 to 33:44 of the 46-minute lecture. recommended: clips judged to teach the topic, best first. fallback: when too few are recommended, related moments with their fallback_reason, not teaching clips. Neither: Bettyapp has no lecture on it. Each clip has its clip_id, lecture, start_seconds, suggested_end_seconds, curriculum place, play_url, classroom_share_url, credit line and licence note. teaching.role (teaches, uses or mentions) and teaching.depth (0, named only, to 3, a thorough treatment) say how an AI review of the transcript judged the moment (judged_by "ai_transcript_review"; not_judged where none was made).
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>",
"age_group": "<age_group>"
},
"name": "search_teaching_clips"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| topic | Yes | The topic's name, as a teacher says it in a lecture: one to four words, for example "mitosis" or "chain rule", not the whole request "a short clip on mitosis for my grade 10 class". | |
| language | No | Only lectures spoken in this language, as its code: en, es, pt. Without it, every language. | |
| age_group | Yes | The age group of the students the class is for: child (under 13), teen (13 to 17) or adult (18 and over). Bettyapp gives clips from lectures that suit the age. | |
| max_results | No | How many clips, 1 to 10. | |
| curriculum_code | No | A course or syllabus place the class follows, as a study guide gives them: a section code ("B2.1", "4.4.1") or a course with it ("SPH4U B2.1"). A clip in it comes first among clips alike. | |
| education_level | No | The class's Level: elementary (Elementary (K–5)), middle_school (Middle School (6–8)), high_school (High School (9–12)), university_year1 (Year 1 University), university_upper (Upper Year University), graduate (Graduate & Professional). A clip at this Level comes first among clips alike; without it, every Level. | |
| target_duration_seconds | No | About how long a clip the teacher wants, in seconds: among clips alike, the nearer length comes first. |