joerawr/scaha.net-mcp

@joerawr/scaha-mcp

Model Context Protocol (MCP) server for SCAHA (Southern California Amateur Hockey Association) youth hockey data. Provides schedule, standings, and player stats via web scraping.

Installation

Claude Desktop

Add to your Claude Desktop config:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "scaha": {
      "command": "npx",
      "args": ["-y", "@joerawr/scaha-mcp"]
    }
  }
}

Restart Claude Desktop after adding.

Chrome/Chromium Required

This server uses Puppeteer for web scraping. Chrome or Chromium must be installed.

Custom Chrome path (optional):

{
  "mcpServers": {
    "scaha": {
      "command": "npx",
      "args": ["-y", "@joerawr/scaha-mcp"],
      "env": {
        "CHROME_EXECUTABLE_PATH": "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
      }
    }
  }
}

Available Tools

get_schedule

Get game schedules with optional date filtering.

Parameters:

• season (required): Season name (e.g., "2025/26")
• schedule (required): Schedule name (e.g., "14U B")
• team (required): Team name (e.g., "Jr. Kings (1)")
• date (optional): Filter to specific date (YYYY-MM-DD)

Example: "When do the 14U B Jr Kings (1) play on 10/12/2025?"

get_team_stats

Get team standings and statistics.

Parameters:

• season (required): Season identifier
• division (required): Division/schedule name (e.g., "14U B" selects "14U B Regular Season")
• team_slug (required): Team identifier

get_division_standings

Get complete standings for all teams in a division.

Parameters:

• season (required): Season identifier (e.g., "2025-26")
• division (required): Division name (e.g., "14U B")

Use cases:

• "What are the teams standings in 14U B?"
• "Who is in first place in the division?"
• "Show me the complete 16U A standings"

Returns: Complete standings table with all teams showing W-L-T-OTL records, points, goals for/against, and goal differential.

get_player_stats

Get individual player statistics.

Parameters:

• season (required): Season identifier
• division (required): Division name
• team_slug (required): Team identifier
• player (required): Object with name or number
• category (optional): Use "goalies" to fetch goalie stats (defaults to skaters). Including the word "goalie" in player.name also switches to goalie stats automatically.

get_division_player_stats

Get complete player statistics rankings for a division. Returns all players sorted by points, optionally filtered by team.

Parameters:

• season (required): Season identifier (e.g., "2024-25")
• division (required): Division name (e.g., "14U B")
• team_slug (optional): Filter to specific team (e.g., "Jr. Kings")
• category (optional): Use "goalies" for goalie stats (defaults to skaters)
• limit (optional): Limit number of results returned

Use cases:

• "Who has the most goals in the division?"
• "Who leads our team in scoring?"
• "Show me the top 10 scorers in 14U A"

Returns: Ranked list of all players with complete stats, metadata about total count, and whether more results exist (when using limit).

get_team_roster

Get complete team roster with all players and goalies in a single call. Perfect for team leaderboard queries.

Parameters:

• season (required): Season identifier (e.g., "2024-25")
• division (required): Division name (e.g., "14U B")
• team_slug (required): Team name or identifier

Use cases:

• "Who has the most points on our team?"
• "Show me all players on the Jr. Kings roster"
• "Who are the top scorers on my team?"
• "List the full team roster with stats"

Returns: Complete roster with both skaters and goalies, including all stats for each player. Much more efficient than calling get_player_stats for each player individually.

get_schedule_csv

Download schedule as CSV (base64 encoded).

Parameters:

• season (required): Season name
• schedule (required): Schedule name
• team (required): Team name

list_schedule_options

List available seasons, schedules, and teams.

Parameters:

• season (optional): Filter by season
• schedule (optional): Filter by schedule
• team (optional): Filter by team

HTTP Deployment (Optional)

For remote deployment, this server also supports HTTP transport via StreamableHTTP.

Deploy to Vercel/Railway:

1. Clone repository: git clone https://github.com/joerawr/scaha.net-mcp.git
2. Install: npm install
3. Build: npm run build:http
4. Deploy the http/ directory
5. Endpoint available at: https://your-domain.com/api/mcp

Note: HTTP transport is for self-hosted deployments. Claude Desktop uses STDIO (above).

Development

git clone https://github.com/joerawr/scaha.net-mcp.git
cd scaha.net-mcp
npm install
npm run build        # Build STDIO server
npm run dev          # Run in dev mode
npm test             # Test STDIO server

Data Source

scaha.net - Southern California Amateur Hockey Association

• Scoreboard: https://www.scaha.net/scaha/scoreboard.xhtml
• Stats Central: https://www.scaha.net/scaha/statscentral.xhtml

Data is scraped using Puppeteer due to JavaServer Faces dynamic content.

License

MIT - See LICENSE file

Contributing

Issues and PRs welcome: https://github.com/joerawr/scaha.net-mcp/issues