@superbuilders/graph-mcp

An MCP server for exploring and reviewing the Primer curriculum graph. Once set up, your AI assistant can browse courses, units, and learning objectives, and raise reviews against a graph version.

What you need

Two values, which you'll get from the Primer team:

| Value | What it is | Looks like | | --- | --- | --- | | Graph host | The address of the Primer Graph API | https://graph.example.com | | Publishable key | Your access key | starts with pk_ |

That's it — no install step, no build, no account login. The server runs on demand.

Setup

You add the server to your AI assistant's config file. Pick your app below, paste the block in, and fill in your two values.

Claude Desktop

1. Open Claude Desktop → Settings → Developer → Edit Config.
2. Add graph-mcp to the mcpServers section:

{
  "mcpServers": {
    "graph-mcp": {
      "command": "npx",
      "args": ["-y", "@superbuilders/graph-mcp"],
      "env": {
        "PRIMER_GRAPH_HOST": "https://graph.example.com",
        "PRIMER_PUBLISHABLE_KEY": "pk_your_key_here"
      }
    }
  }
}

3. Save the file and restart Claude Desktop.

Claude Code

Run this in your terminal, with your two values filled in:

claude mcp add graph-mcp \
  --env PRIMER_GRAPH_HOST=https://graph.example.com \
  --env PRIMER_PUBLISHABLE_KEY=pk_your_key_here \
  -- npx -y @superbuilders/graph-mcp

Checking it works

After restarting, ask your assistant something like "List the available Primer courses." If it returns a list of courses, you're set.

Troubleshooting

• Nothing happens / server won't start — Double-check both values are filled in. The publishable key must start with pk_, and the host must be a full URL beginning with https://.
• Changes not taking effect — Fully quit and reopen the app after editing the config.

What it can do

Once connected, the assistant can:

• List and look up courses and their units
• View a course at a specific grade level
• Read a single learning objective's details
• Trace what comes before and after an objective in the curriculum
• List the reviews on a curriculum-graph version, create a review against one or more objectives, and propagate a version's reviews forward onto a successor version

Browsing is read-only; the review tools (create_review, propagate_reviews) write, and only ever add reviews — they never edit the graph itself.