Oak Curriculum MCP - Invite Only Public Alpha

You MUST call this tool before using other curriculum tools. Use this when you need to understand: - The Oak curriculum domain model (key stages, subjects, entity hierarchy, property graph) - Which tools are available and how to use them - Common workflows for finding and using curriculum content - How to interpret ID formats for the 'fetch' tool Do NOT use for: - Fetching actual curriculum content (use 'search' or 'fetch') - Looking up specific lessons, units, or resources Optionally provide a tool_name to also include specific help for that tool.

PREREQUISITE: You MUST call `get-curriculum-model` first to understand the curriculum domain. Returns structured facet data showing subjects, key stages, sequences (programmes), units, and lesson counts. Useful for orientation and discovery. Use this when: - The teacher wants to see what's available ("What subjects do you have?") - The teacher wants to browse a subject ("Show me the maths curriculum") - The teacher wants to see what's at a key stage ("What's in KS2?") - You need to understand curriculum structure before searching Do NOT use for: - Searching for specific content (use 'search' with a query) - Getting full lesson details (use 'fetch') - Understanding the domain model (use 'get-curriculum-model') NATURAL LANGUAGE MAPPING EXAMPLES: - "What subjects are available?" → no arguments (returns all facets) - "Show me KS2 science" → { subject: 'science', keyStage: 'ks2' } - "What's in the maths curriculum?" → { subject: 'maths' } - "What subjects are at Key Stage 3?" → { keyStage: 'ks3' }

PREREQUISITE: You MUST call `get-curriculum-model` first to understand the curriculum domain. Searches lessons, units, AND learning threads in parallel for a topic, returning a unified topic map showing what's available across all scopes. Returns a small set from each scope (top 5) for a quick overview. Use this when: - The teacher says "What does Oak have about volcanos?" - The teacher says "I want to teach about electricity" - You need to discover what content exists before drilling down - The teacher's intent doesn't clearly map to one scope - The teacher mentions a subject and you need cross-scope results (pass the subject parameter explicitly) Do NOT use for: - Precise search in a single scope (use 'search' with a specific scope) - Browsing without a topic (use 'browse-curriculum') - Fetching known content by ID (use 'fetch') - Understanding the curriculum structure (use 'get-curriculum-model') NATURAL LANGUAGE MAPPING EXAMPLES: - "What does Oak have about volcanos?" → { query: 'volcanos' } - "Explore fractions across the curriculum" → { query: 'fractions', subject: 'maths' } - "Explore maths topics" → { query: 'topics', subject: 'maths' } - "I want to teach about electricity in KS3" → { query: 'electricity', keyStage: 'ks3' } - "What can you tell me about the Romans?" → { query: 'the Romans' } NEXT STEPS AFTER EXPLORE: - Use search(scope: 'lessons') for more lesson results - Use search(scope: 'threads') for progression details - Use fetch(lesson:slug) for full lesson content - Use get-thread-progressions for ordered unit sequences

PREREQUISITE: You MUST call `get-curriculum-model` first to understand the curriculum domain. Required parameters: `scope` (which index to search) and `query` (your search query). For `threads` scope, `query` may be omitted if `subject` or `keyStage` is provided. SCOPE SELECTION — choose the right scope for the teacher's intent: - "lessons": Find specific lessons on a topic. Best for "find me a lesson about X". - "units": Find teaching units (groups of lessons). Best for "what units cover X?". - "threads": Find learning progression strands across year groups. Best for "how does X build across years?". If the teacher mentions a subject (for example, "maths threads"), pass it in the subject filter parameter rather than relying on the query alone. - "sequences": Find curriculum programme structures. Best for "show me the programme for X". Sequence names are structural (for example, "maths-secondary"), so broad subject terms should be passed via subject filters. - "suggest": Typeahead suggestions as the user types. Best for autocomplete. Use this when you need to: - Find lessons, units, threads, or sequences on a topic - Search with specific filters (key stage, subject, year, tier) - Get typeahead suggestions for a partial query - Discover what content exists for a subject or topic Do NOT use for: - Fetching known content by ID (use 'fetch') - Understanding the curriculum structure (use 'get-curriculum-model') - Browsing what's available without a search query (use 'browse-curriculum') - Exploring a topic across multiple indexes at once (use 'explore-topic') NATURAL LANGUAGE MAPPING EXAMPLES: - "Find KS3 science lessons about photosynthesis" → scope: 'lessons', query: 'photosynthesis', subject: 'science', keyStage: 'ks3' - "What units cover fractions in primary maths?" → scope: 'units', query: 'fractions', subject: 'maths', keyStage: 'ks2' - "What's the learning progression for algebra?" → scope: 'threads', query: 'algebra', subject: 'maths' - "What maths threads are there?" → scope: 'threads', subject: 'maths' (no query needed — returns all maths threads sorted by size) - "Show me secondary science programmes" → scope: 'sequences', query: 'science', keyStage: 'ks3' - "Find lessons on the Romans for Year 3" → scope: 'lessons', query: 'Romans', year: '3' - "KS4 higher tier maths on trigonometry" → scope: 'lessons', query: 'trigonometry', keyStage: 'ks4', tier: 'higher' SCOPE LIMITATIONS: - "suggest" requires at least one filter: subject or keyStage. - "sequences" works best with structural names (for example, "maths-secondary"), not topic words. - "threads" can omit query when subject or keyStage is provided, returning all matching threads sorted by unit count. CROSS-TOOL WORKFLOWS: - For lesson planning: search(scope: 'lessons') → fetch(lesson:slug) for full details - For prerequisites: search(scope: 'threads') → get-prerequisite-graph for dependencies - For progressions: search(scope: 'threads') → get-thread-progressions for ordered units

PREREQUISITE: You MUST call `get-curriculum-model` first to understand the curriculum domain before using the fetch tool. Use this when you need to: - Get lesson details (learning objectives, keywords, misconceptions) - Get unit information (lessons list, subject context) - Get subject or sequence overview - Retrieve thread progression data Do NOT use for: - Finding content when you don't have the ID (use 'search') - Understanding ID formats (use 'get-curriculum-model' first) Use format "type:slug" (e.g., "lesson:add-fractions-with-the-same-denominator", "unit:comparing-fractions").

This instance-level graph shows ordered unit sequences within curriculum threads: - 164 threads across 16 subjects - Each thread contains ordered units showing the learning progression - Year spans show when concepts are taught (e.g., "Number: Fractions" from Year 2-6) Example threads: - "Number: Fractions" (maths) — units from Year 2 through Year 6 - "Active citizenship" (citizenship) — units from Year 7 through Year 10 Use this to answer questions like: - "What's the learning path for fractions?" - "What comes after this unit in the thread?" - "Which threads cover algebra?" PREREQUISITE: You MUST call `get-curriculum-model` first to understand the curriculum domain. Complements get-curriculum-model (which includes the schema-level property graph) with actual progression data.

This instance-level graph shows unit dependencies and prior knowledge requirements: - 1607 units with prior knowledge requirements - 3452 prerequisiteFor edges derived from thread ordering - 16 subjects covered Each node contains: - Unit metadata (slug, title, subject, key stage, year) - Prior knowledge requirements (what students should know before) - Thread memberships (which curriculum threads this unit belongs to) Edges show prerequisiteFor relationships: - Derived from thread ordering (earlier unit → later unit in same thread) Use this to answer questions like: - "What should students know before trigonometry?" - "What's the learning path to algebra?" - "Which units depend on fractions?" PREREQUISITE: You MUST call `get-curriculum-model` first to understand the curriculum domain. Complements get-thread-progressions (learning paths) with prerequisite detail.

Returns a clickable URL valid for 5 minutes that downloads the asset directly in the user's browser — no authentication needed on their side. Use this when: - The user wants to download a slide deck, worksheet, quiz, or video - You have the lesson slug and asset type from a previous get-lessons-assets call IMPORTANT: When presenting download links to the user, always include this tip (once, not per-link): "Our resources work best if you install the Google Fonts Lexend and Kalam — https://support.thenational.academy/how-to-install-the-google-fonts-lexend-and-kalan" Do NOT use for: - Browsing available assets (use 'get-lessons-assets' first) - Getting lesson content or metadata (use 'fetch')

This tool returns all the key stages (titles and slugs) that are currently available on Oak PREREQUISITE: You MUST call the `get-curriculum-model` tool first to understand the curriculum domain.

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: You MUST call the `get-curriculum-model` tool first to understand the curriculum domain. NOTE: The asset `url` fields returned by this tool are authenticated API endpoints and cannot be used as direct browser download links. To generate a clickable download link for the user, call the `download-asset` tool with the lesson slug and asset type. If `download-asset` is not available (e.g. stdio transport), direct users to the lesson page on the Oak website — use the lesson's `canonicalUrl` (e.g. `https://www.thenational.academy/teachers/lessons/{lessonSlug}`).

This tool returns an array of available published lessons for a given subject and key stage, grouped by unit. PREREQUISITE: You MUST call the `get-curriculum-model` tool first to understand the curriculum domain.

This tool returns quiz questions and answers for each lesson within a requested subject and key stage. PREREQUISITE: You MUST call the `get-curriculum-model` tool first to understand the curriculum domain.

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: You MUST call the `get-curriculum-model` tool first to understand the curriculum domain.

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: You MUST call the `get-curriculum-model` tool first to understand the curriculum domain. NOTE: The asset `url` fields returned by this tool are authenticated API endpoints and cannot be used as direct browser download links. To generate a clickable download link for the user, call the `download-asset` tool with the lesson slug and asset type. If `download-asset` is not available (e.g. stdio transport), direct users to the lesson page on the Oak website — use the lesson's `canonicalUrl` (e.g. `https://www.thenational.academy/teachers/lessons/{lessonSlug}`).

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: You MUST call the `get-curriculum-model` tool first to understand the curriculum domain.

This tool returns a summary for a given lesson PREREQUISITE: You MUST call the `get-curriculum-model` tool first to understand the curriculum domain.

This tool returns the video transcript and video captions file for a given lesson. PREREQUISITE: You MUST call the `get-curriculum-model` tool first to understand the curriculum domain.

NOTE: A response of limit=0, remaining=0, reset=0 indicates an unlimited API key with no rate cap.

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: You MUST call the `get-curriculum-model` tool first to understand the curriculum domain. NOTE: The asset `url` fields returned by this tool are authenticated API endpoints and cannot be used as direct browser download links. To generate a clickable download link for the user, call the `download-asset` tool with the lesson slug and asset type. If `download-asset` is not available (e.g. stdio transport), direct users to the lesson page on the Oak website — use the lesson's `canonicalUrl` (e.g. `https://www.thenational.academy/teachers/lessons/{lessonSlug}`).

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: You MUST call the `get-curriculum-model` tool first to understand the curriculum domain.

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: You MUST call the `get-curriculum-model` tool first to understand the curriculum domain.

This tool returns the sequences, key stages and years that are currently available for a given subject. PREREQUISITE: You MUST call the `get-curriculum-model` tool first to understand the curriculum domain.

This tool returns an array of all available subjects and their associated sequences, key stages and years. PREREQUISITE: You MUST call the `get-curriculum-model` tool first to understand the curriculum domain.

This tool returns a list of key stages that are currently available for a given subject. PREREQUISITE: You MUST call the `get-curriculum-model` tool first to understand the curriculum domain.

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: You MUST call the `get-curriculum-model` tool first to understand the curriculum domain.

This tool returns an array of years that are currently available for a given subject. PREREQUISITE: You MUST call the `get-curriculum-model` tool first to understand the curriculum domain.

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: You MUST call the `get-curriculum-model` tool first to understand the curriculum domain.

This tool returns all of the units that belong to a given thread. PREREQUISITE: You MUST call the `get-curriculum-model` tool first to understand the curriculum domain.

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: You MUST call the `get-curriculum-model` tool first to understand the curriculum domain.