joerawr/pghl-mcp

@joerawr/pghl-mcp

Model Context Protocol (MCP) server for PGHL (Pacific Girls Hockey League) schedule data. Provides team schedules and discovery via web scraping from pacificgirlshockey.com.

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": {
    "pghl": {
      "command": "npx",
      "args": ["-y", "@joerawr/pghl-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": {
    "pghl": {
      "command": "npx",
      "args": ["-y", "@joerawr/pghl-mcp"],
      "env": {
        "CHROME_EXECUTABLE_PATH": "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
      }
    }
  }
}

Available Tools

list_schedule_options

Discover available seasons, divisions, and teams through progressive discovery.

Parameters:

• season (optional): Filter by season to get divisions (e.g., "2025-26")
• division (optional): Filter by division to get teams (requires season, e.g., "12u AA")

Example queries:

• "What seasons are available in PGHL?"
• "What divisions are in the 2025-26 PGHL season?"
• "What teams are in 12u AA for 2025-26?"

Progressive Discovery:

1. Call with no parameters → get all seasons
2. Call with season → get divisions for that season
3. Call with season + division → get teams in that division

get_schedule

Get full game schedule for a team.

Parameters:

• season (required): Season identifier (e.g., "2025-26")
• division (required): Division name (e.g., "12u AA", "14u AAA")
• team (required): Team name (e.g., "Las Vegas Storm 12u AA")

Example queries:

• "Get the schedule for Las Vegas Storm 12u AA in 2025-26"
• "When does Las Vegas Storm 12u AA play next?" (LLM can filter future games)
• "Does Las Vegas Storm 12u AA play on October 15, 2025?" (LLM can filter by date)
• "Who does Las Vegas Storm play this weekend?" (LLM can filter date range)

HTTP Deployment (Optional)

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

Deploy to Vercel:

1. Clone repository: git clone https://github.com/joerawr/pghl-mcp.git
2. Install: npm install
3. Build: npm run build:http
4. Deploy the http/ directory to Vercel
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/pghl-mcp.git
cd pghl-mcp
npm install
npm run build        # Build STDIO server
npm run dev          # Run in dev mode
npm test             # Test STDIO server

Environment Variables

Create a .env file (see .env.example):

# Chrome executable path (required for Puppeteer)
CHROME_EXECUTABLE_PATH=/Applications/Google Chrome.app/Contents/MacOS/Google Chrome

# PGHL website URL (default: https://www.pacificgirlshockey.com)
PGHL_WEBSITE_URL=https://www.pacificgirlshockey.com

# Node environment
NODE_ENV=development

Data Source

pacificgirlshockey.com - Pacific Girls Hockey League

• Schedule URL: https://www.pacificgirlshockey.com/schedule

Data is scraped using Puppeteer from the HockeyShift platform.

Features

• ✅ Team schedule retrieval with date, time, opponent, venue
• ✅ Progressive team discovery (season → division → team)
• ✅ Natural language queries supported (LLM filters schedule data)
• ✅ Dual transport support (STDIO for Claude Desktop + StreamableHTTP for Vercel)
• ✅ Partial team name matching for user convenience
• ✅ Vercel deployment ready

License

MIT - See LICENSE file

Contributing

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

Related Projects

• scaha-mcp - SCAHA hockey league MCP server
• Hockey Go Time - Conversational AI for hockey schedules