Skip to content

AI Integration via MCP

Curriculum Planner includes a built-in MCP (Model Context Protocol) server. This lets you connect an AI assistant directly to your curriculum database so you can ask questions and get help in natural language.

What is MCP?

MCP is an open standard that lets AI tools connect to external data sources. Curriculum Planner exposes your local curriculum database as an MCP server, so an AI can read your data and help you work with it — without you having to copy and paste anything.

What can the AI do?

Once connected, an AI assistant can:

  • Answer questions about your curriculum data ("What units do I have?", "Which chunks haven't been assessed yet?")
  • Find curriculum items by topic or keyword ("Find content descriptions about binary")
  • Help break down curriculum items into chunks ("Create 'I can' statements for AC9TDI6K03")
  • Add chunks to units

The AI has read access to all your curriculum data and can create and organise chunks on your behalf.

Requirements

  • Curriculum Planner must be running (the backend starts automatically when you open the app)
  • Claude Code (recommended) or another MCP-compatible client

Claude Code is a command-line AI tool that supports the HTTP MCP transport used by Curriculum Planner.

  1. Install Claude Code
  2. Open a terminal
  3. Register the MCP server:
claude mcp add --transport http curriculum http://localhost:3000/mcp
  1. Open Curriculum Planner so the backend is running
  2. Start a new Claude Code session — it will have access to your curriculum data

You can verify it's working by asking: "What units are in my curriculum database?"

Other MCP clients

Curriculum Planner uses the MCP Streamable HTTP transport (POST http://localhost:3000/mcp). Any client that supports this transport can connect.

Claude Desktop currently only supports stdio-based MCP servers and cannot connect directly via HTTP. Support may be added in a future update.

Cursor, Windsurf, and others — check your client's documentation for how to add an HTTP MCP server at http://localhost:3000/mcp.

Example prompts

Once connected, try asking:

  • "How many units do I have and what are they called?"
  • "Find me all chunks related to networks"
  • "What curriculum items haven't been broken down into chunks yet?"
  • "Create I can and I know statements for AC9TDI6K03 and add them to the Digital Representation unit"