Bettyapp lecture moments

npx add-mcp 'https://bettyapp.org/mcp'

Bettyapp for AI tutors

Bettyapp finds the moments in university and school lectures where a topic is explained. An AI tutor (ChatGPT, Claude, Gemini, a school's own chatbot) can ask Bettyapp for the moments that explain a student's topic or question, and send the student to the lecture at that moment. The API and the MCP server are free and read-only.

What it answers

• search_moments: call it first, with a topic's name as a teacher says it (one to four words, like integration by parts, not the student's whole question), and if you like a Subject and a Level. It answers up to 10 moments, best first. The Level is strict: if nothing comes back, try again without it.
• get_lecture: a lecture by its id or its page's address, with all its moments.
• get_topic: a topic, with the best moment that explains it at each Level, from school to university, for an explanation at a particular Level, or an easier or a harder one. The first moment is the lowest Level: pick the one at the student's Level.
• list_subjects and list_levels: the Subjects and Levels you can search in.
• find_for_problem: one problem from an assignment or a textbook page, as you read it from the student’s photo, with its topic’s name (for example product rule for derivatives): the moments that explain it, a similar practice question and the open textbook’s section. Bettyapp never sees the photo and never gives the answer. For a whole page, call it once for each question.
• lookup_textbook_code: the code under the QR code in an Indian school textbook (a DIKSHA DIAL code, such as 1064CH01), or the QR code’s address: the board, class, subject, book and chapter, and the moments for the chapter. The chapter comes from DIKSHA (diksha.gov.in), credited in each answer.

Each moment has its lecture, course and teacher, its Subject and Level, where it starts and ends, a title and summary and the questions it answers (where the lecture page has them), its topics, a short excerpt of what the teacher says where the licence allows it, the credit line and licence, a play address and a picture. The play address is the lecture page on Bettyapp, playing from the moment. No answer has a whole transcript.

Only lectures with a page on Bettyapp are in the answers. When an answer has no moments, Bettyapp has nothing on that topic.

The MCP server

Add this address to an MCP client (Claude, ChatGPT and others that connect to remote MCP servers by their address):

https://bettyapp.org/mcp

The address ends in /mcp. If Claude says “Couldn’t register with bettyapp.org’s sign-in service”, the connector was added without /mcp: remove it, and add it again with https://bettyapp.org/mcp. The server needs no sign-in.

It speaks MCP over Streamable HTTP and needs no sign-in. Its tools are search_moments, get_lecture, get_topic, list_subjects, find_for_problem and lookup_textbook_code, with descriptions written for an AI tutor, and search and fetch, the pair ChatGPT's deep research uses. It also offers four prompts a student can pick in their AI app (in Claude, from the + menu): find_a_lecture, help_with_homework, study_for_test and explain_more_simply. For the higher limits, add your developer key as a header: Authorization: Bearer bdev_….

The steps for each AI app (Claude, ChatGPT, Gemini, Copilot, Cursor and others) are on Use with AI tutors.

The skill file

A skill file tells an AI app or agent how to connect to Bettyapp, when to call each tool, and how to give a student a moment: https://bettyapp.org/skill.md. It is in the Agent Skills format (SKILL.md, with reference files). To upload it to Claude or another app that takes skills, download the zip: https://bettyapp.org/skills/bettyapp-mcp.zip.

Bettyapp for Teachers

A second MCP server, for a teacher planning a class. It finds the few minutes inside a long lecture where a teacher explains a topic, such as minutes 28 to 33 of an MIT calculus lecture on the chain rule, and gives each clip with where it starts and a suggested end, the lecture and its teacher, the credit line and a short note on its licence. It follows the courses and exam syllabuses teachers work from (Ontario, England's GCSE and A level, Cambridge International, Singapore and others), and suggests the topics to teach before and after a topic.

Add this address to Claude, ChatGPT or another app that connects to remote MCP servers:

https://bettyapp.org/mcp/teachers

It needs no sign-in and is read-only. Its tools are search_teaching_clips (clips that teach a topic, for a class's Level), list_curricula and find_by_curriculum (a course's topics in order, with their curriculum codes and a clip for each), get_clip (one clip in full), get_topic_pathway (the topics to teach before and after a topic) and get_levels (a topic at each Level). It also offers three prompts a teacher can pick in Claude, from the + menu: Find a clip for a lesson, Clips for a course or a unit, and What to teach before and after a topic.

For example, ask: Find a few minutes from a university lecture where the chain rule is worked through on an example, for my Grade 12 calculus class.

Bettyapp for Teachers asks for no student names, marks or work, and keeps what it is sent to a minimum, as the Privacy notice says. A clip's licence note is a short summary, not legal advice. The guide for AI apps and agents is the skill file at https://bettyapp.org/skills/bettyapp-teachers/SKILL.md. The same terms and limits apply as for the student server, below.

The REST API

Every call is a GET under https://bettyapp.org/api/v1/ and answers JSON. Any website may call it from the browser (CORS is open). The OpenAPI 3.1 description is at /api/v1/openapi.json: import it into a custom GPT's Actions, or any tool that reads OpenAPI.

Try it: click one of these links to see what the API answers.

• Search: integration by parts
• Search: photosynthesis, at High School
• Topic: chain rule, the best moment at each Level
• A problem: find dy/dx if y = x² sin x, with its topic
• A textbook code: NCERT Science Class 10, chapter 1
• The Subjects and their Levels
• The Levels
• The OpenAPI 3.1 description

Every answer has an attribution line and a terms address. Follow the attribution: link the moment's play_url and show its credit.line.

Limits and keys

• Without a key: 20 calls a minute and 500 a day for each network address.
• With a free developer key: 120 calls a minute and 10,000 a day for each key.
• Short transcript excerpts also count toward the site's hourly limit on excerpts, for each key or address.

Past a limit, a call answers 429 with retry_after_seconds. Send the key in a header: Authorization: Bearer bdev_…, or X-Bettyapp-Key: bdev_…. Never put it in an address.

Get a developer key

Type your email address and what the key is for, and click Email me a key. We email you a link that works for 24 hours. Click it, then click Get my key: the key is shown once. An address may have 5 keys at a time. To stop a key, write to contact@bettyapp.org.

We keep your email address, what the key is for and when the key was last used, as the Privacy notice says.

Terms

1. The API and the MCP server are free to use.
2. Use them to send students to moments: give the student the moment's play address (play_url), which opens the lecture page on Bettyapp at that moment.
3. Include the lecture's credit line (credit.line) wherever you link a moment, and say that the moment was found with Bettyapp.
4. Do not download Bettyapp in bulk: no copying of all the lectures, topics or moments, no mirror of the site, no scraping round the limits.
5. Do not use what the API answers to train or fine-tune AI models. Many lectures are under licences that do not allow commercial use (for example CC BY-NC-SA), and they belong to their creators.
6. Use only what an answer says. When an answer has no moments, Bettyapp has nothing on that topic: do not say that it has.
7. Keep a developer key private. It goes in a request's header, never in an address or a page that others can read.
8. Bettyapp may change the limits, or stop a key that is used against these terms.

The lectures belong to their creators, under the licences their pages show (Sources and licences). Bettyapp's own Terms and copyright apply too. Questions: contact@bettyapp.org.