# PuckAPI MCP Server

15 hockey data tools for AI assistants. The hockey API for stats, odds, and everything between. REST API and MCP server. Free to start. All tools return structured output schemas for reliable parsing.

## Server URL

```
https://mcp.puckapi.com/mcp?key=YOUR_API_KEY
```

Transport: Streamable HTTP

## Get an API Key

1. Sign up at https://puckapi.com/signup (free, 500 credits included)
2. Go to https://puckapi.com/dashboard/keys
3. Create a key (starts with `sk_live_`)

## Setup

### Claude Code

```bash
claude mcp add --transport http --scope user puckapi "https://mcp.puckapi.com/mcp?key=YOUR_API_KEY"
```

### Claude Desktop

Add to config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS, `%APPDATA%\Claude\claude_desktop_config.json` on Windows):

```json
{
  "mcpServers": {
    "puckapi": {
      "url": "https://mcp.puckapi.com/mcp?key=YOUR_API_KEY"
    }
  }
}
```

### Cursor

Add to `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "puckapi": {
      "url": "https://mcp.puckapi.com/mcp?key=YOUR_API_KEY"
    }
  }
}
```

### VS Code (GitHub Copilot)

Add to `.vscode/mcp.json`:

```json
{
  "servers": {
    "puckapi": {
      "type": "streamable-http",
      "url": "https://mcp.puckapi.com/mcp?key=YOUR_API_KEY"
    }
  }
}
```

### Cline

Settings > MCP Servers > Add Remote Server:
- Name: `puckapi`
- URL: `https://mcp.puckapi.com/mcp?key=YOUR_API_KEY`

### Windsurf

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

```json
{
  "mcpServers": {
    "puckapi": {
      "serverUrl": "https://mcp.puckapi.com/mcp?key=YOUR_API_KEY"
    }
  }
}
```

## Available Tools

| Category | Tools | Credits |
|----------|-------|---------|
| Static reference | list_teams | 1 |
| Basic lookup | get_standings, get_schedule, search_players | 2 |
| Stats + aggregation | get_games, get_team_stats, get_player_stats, get_goalie_stats, get_skater_season_stats | 5 |
| Multi-table | get_odds, get_game_detail, get_head_to_head, get_plays, get_shot_map | 10 |
| Time-series | get_line_movement | 25 |

## Pricing

500 free credits on signup. Plans from $19/mo at https://puckapi.com/dashboard/billing.

## Documentation

Full API docs: https://puckapi.com/docs
MCP setup guide: https://puckapi.com/docs#claude-desktop