Skip to content
MCP server

Maxpreps MCP

MaxPreps MCP — high school schedules, scores, records, rosters and stat leaders

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.2.0
Listing updated
5 days ago

About Maxpreps MCP

Maxpreps MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add maxpreps-mcp -- npx -y maxpreps-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "maxpreps-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "maxpreps-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "maxpreps-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "maxpreps-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "maxpreps-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "maxpreps-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "maxpreps-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "maxpreps-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "maxpreps-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "maxpreps-mcp"
      ]
    }
  }
}

Configuration

  • MAXPREPS_USER_AGENTOptional override for the User-Agent sent to MaxPreps.
  • MAXPREPS_CACHE_TTLSeconds to cache a page response. Default 300; 0 disables caching.
  • MAXPREPS_MIN_INTERVAL_MSMinimum spacing between requests, in ms. Default 250.

Pricing

Open source

Maxpreps MCP FAQ

Is Maxpreps MCP free?

Yes. Maxpreps MCP is open source, so you can use and self-host it for free.

How do I add Maxpreps MCP to Claude Code?

Run this command in your terminal: claude mcp add maxpreps-mcp -- npx -y maxpreps-mcp