Oak Curriculum MCP - Internal Alpha

Documentation resources available via MCP resources/read:

• docs://oak/getting-started.md Getting Started with Oak Curriculum Introduction to the Oak Curriculum MCP server, authentication, and first steps.
• docs://oak/tools.md Tool Reference Complete reference of all available tools organised by category with usage guidance.
• docs://oak/workflows.md Common Workflows Step-by-step guides for common tasks like finding lessons and planning.

Prompts are workflow templates that guide common curriculum tasks:

• find-lessons Find curriculum lessons on a specific topic. Searches across all subjects and key stages to find relevant lessons. Arguments: topic, keyStage (optional)
• lesson-planning Gather materials for planning a lesson on a topic, including objectives, transcript, quiz questions, and resources. Arguments: topic, yearGroup
• progression-map Map how a concept develops across years in a subject, showing progression from early learning to GCSE. Arguments: concept, subject

The following tools are available via the MCP protocol:

• get-changelog History of significant changes to the API with associated dates and versions
• get-changelog-latest Get the latest version and latest change note for the API
• get-key-stages Key stages This tool returns all the key stages (titles and slugs) that are currently available on Oak PREREQUISITE: If unfamiliar with Oak's curriculum structure, call `get-ontology` first to understand key stages, subjects, entity hierarchy, and ID formats.
• get-key-stages-subject-assets Assets This tool returns signed download URLs and types for available assets for a given key stage and subject, grouped by lesson. You can also optionally filter by type and unit. PREREQUISITE: If unfamiliar with Oak's curriculum structure, call `get-ontology` first to understand key stages, subjects, entity hierarchy, and ID formats.
• get-key-stages-subject-lessons Lessons This tool returns an array of available published lessons for a given subject and key stage, grouped by unit. PREREQUISITE: If unfamiliar with Oak's curriculum structure, call `get-ontology` first to understand key stages, subjects, entity hierarchy, and ID formats.
• get-key-stages-subject-questions Quiz questions by subject and key stage This tool returns quiz questions and answers for each lesson within a requested subject and key stage. PREREQUISITE: If unfamiliar with Oak's curriculum structure, call `get-ontology` first to understand key stages, subjects, entity hierarchy, and ID formats.
• get-key-stages-subject-units Units This tool returns an array of units containing available published lessons for a given key stage and subject, grouped by year. Units without published lessons will not be returned by this tool. PREREQUISITE: If unfamiliar with Oak's curriculum structure, call `get-ontology` first to understand key stages, subjects, entity hierarchy, and ID formats.
• get-lessons-assets Downloadable lesson assets This tool returns the types of available assets for a given lesson, and the download endpoints for each. This tool contains licence information for any third-party content contained in the lesson’s downloadable resources. Third-party content is exempt from the open-government license, and users will need to consider whether their use is covered by the stated licence, or if they need to procure their own agreement. PREREQUISITE: If unfamiliar with Oak's curriculum structure, call `get-ontology` first to understand key stages, subjects, entity hierarchy, and ID formats.
• get-lessons-assets-by-type Lesson asset by type This tool will stream the downloadable asset for the given lesson and type. There is no response returned for this tool as it returns a content attachment. PREREQUISITE: If unfamiliar with Oak's curriculum structure, call `get-ontology` first to understand key stages, subjects, entity hierarchy, and ID formats.
• get-lessons-quiz Quiz questions by lesson The endpoint returns the quiz questions and answers for a given lesson. The answers data indicates which answers are correct, and which are distractors. PREREQUISITE: If unfamiliar with Oak's curriculum structure, call `get-ontology` first to understand key stages, subjects, entity hierarchy, and ID formats.
• get-lessons-summary Lesson summary This tool returns a summary for a given lesson PREREQUISITE: If unfamiliar with Oak's curriculum structure, call `get-ontology` first to understand key stages, subjects, entity hierarchy, and ID formats.
• get-lessons-transcript Lesson transcript This tool returns the video transcript and video captions file for a given lesson. PREREQUISITE: If unfamiliar with Oak's curriculum structure, call `get-ontology` first to understand key stages, subjects, entity hierarchy, and ID formats.
• get-rate-limit Check your current rate limit status (note that your rate limit is also included in the headers of every response). This specific endpoint does not cost any requests.
• get-search-lessons Lesson search using lesson title Search for a term and find the 20 most similar lessons with titles that contain similar text. PREREQUISITE: If unfamiliar with Oak's curriculum structure, call `get-ontology` first to understand key stages, subjects, entity hierarchy, and ID formats.
• get-search-transcripts Lesson search using lesson video transcripts Search for a term and find the 5 most similar lessons whose video transcripts contain similar text. PREREQUISITE: If unfamiliar with Oak's curriculum structure, call `get-ontology` first to understand key stages, subjects, entity hierarchy, and ID formats.
• get-sequences-assets Assets within a sequence This tool returns all assets for a given sequence, and the download endpoints for each. The assets are grouped by lesson. This tool contains licence information for any third-party content contained in the lesson’s downloadable resources. Third-party content is exempt from the open-government license, and users will need to consider whether their use is covered by the stated licence, or if they need to procure their own agreement. PREREQUISITE: If unfamiliar with Oak's curriculum structure, call `get-ontology` first to understand key stages, subjects, entity hierarchy, and ID formats.
• get-sequences-questions Questions within a sequence This tool returns all quiz questions for a given sequence. The assets are separated into starter quiz and entry quiz arrays, grouped by lesson. PREREQUISITE: If unfamiliar with Oak's curriculum structure, call `get-ontology` first to understand key stages, subjects, entity hierarchy, and ID formats.
• get-sequences-units Units within a sequence This tool returns high-level information for all of the units in a sequence. Units are returned in the intended sequence order and are grouped by year. PREREQUISITE: If unfamiliar with Oak's curriculum structure, call `get-ontology` first to understand key stages, subjects, entity hierarchy, and ID formats.
• get-subject-detail Subject This tool returns the sequences, key stages and years that are currently available for a given subject. PREREQUISITE: If unfamiliar with Oak's curriculum structure, call `get-ontology` first to understand key stages, subjects, entity hierarchy, and ID formats.
• get-subjects Subjects This tool returns an array of all available subjects and their associated sequences, key stages and years. PREREQUISITE: If unfamiliar with Oak's curriculum structure, call `get-ontology` first to understand key stages, subjects, entity hierarchy, and ID formats.
• get-subjects-key-stages Key stages within a subject This tool returns a list of key stages that are currently available for a given subject. PREREQUISITE: If unfamiliar with Oak's curriculum structure, call `get-ontology` first to understand key stages, subjects, entity hierarchy, and ID formats.
• get-subjects-sequences Sequencing information for a given subject This tool returns an array of sequence objects that are currently available for a given subject. For secondary sequences, this includes information about key stage 4 variance such as exam board sequences and non-GCSE ‘core’ unit sequences. PREREQUISITE: If unfamiliar with Oak's curriculum structure, call `get-ontology` first to understand key stages, subjects, entity hierarchy, and ID formats.
• get-subjects-years Year groups for a given subject This tool returns an array of years that are currently available for a given subject. PREREQUISITE: If unfamiliar with Oak's curriculum structure, call `get-ontology` first to understand key stages, subjects, entity hierarchy, and ID formats.
• get-threads Threads This tool returns an array of all threads, across all subjects. Threads signpost groups of units that link to one another, building a common body of knowledge over time. They are an important component of how Oak’s curricula are sequenced. PREREQUISITE: If unfamiliar with Oak's curriculum structure, call `get-ontology` first to understand key stages, subjects, entity hierarchy, and ID formats.
• get-threads-units Units belonging to a given thread This tool returns all of the units that belong to a given thread. PREREQUISITE: If unfamiliar with Oak's curriculum structure, call `get-ontology` first to understand key stages, subjects, entity hierarchy, and ID formats.
• get-units-summary Unit summary This tool returns unit information for a given unit, including slug, title, number of lessons, prior knowledge requirements, national curriculum statements, prior unit details, future unit descriptions, and lesson titles that form the unit PREREQUISITE: If unfamiliar with Oak's curriculum structure, call `get-ontology` first to understand key stages, subjects, entity hierarchy, and ID formats.