@currikon/mcp

Model Context Protocol server for the Currikon curriculum API.

The package is API-backed and does not bundle the curriculum dataset. It connects to https://api.currikon.org by default and uses your Currikon API key for authenticated requests.

Install

Claude Code:

claude mcp add -s user -e CURRIKON_API_KEY=ck_live_... currikon -- npx -y @currikon/mcp

Claude Desktop / Cursor:

{
  "mcpServers": {
    "currikon": {
      "command": "npx",
      "args": ["-y", "@currikon/mcp"],
      "env": {
        "CURRIKON_API_KEY": "ck_live_..."
      }
    }
  }
}

Use staging:

{
  "env": {
    "CURRIKON_API_KEY": "ck_live_...",
    "CURRIKON_API_BASE_URL": "https://staging-api.currikon.org"
  }
}

Tools

• get_status — dataset counts, jurisdictions, subjects
• search_competencies — full-text search across curriculum competencies
• get_competency — fetch one competency by stable code
• list_competencies — filter by jurisdiction, subject, school type, grade
• get_progression — prerequisites and successors for a competency
• find_equivalents — cross-jurisdiction equivalents
• list_frameworks — curriculum frameworks
• align_competencies — align free text to matching competencies

Local Development

npm install
npm --prefix packages/mcp run build
CURRIKON_API_KEY=ck_live_... npm --prefix packages/mcp run dev