# EndzoneAPI MCP Server

17 football data tools for AI assistants. Play-by-play, player and team stats, schedules, injuries, and odds for pro football. REST API and MCP server. Free to start. All tools return structured output schemas for reliable parsing.

## Server URL

```
https://football-mcp-production.up.railway.app/mcp?key=YOUR_API_KEY
```

Transport: Streamable HTTP

## Get an API Key

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

## Setup

### Claude Code

```bash
claude mcp add --transport http --scope user endzoneapi "https://football-mcp-production.up.railway.app/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": {
    "endzoneapi": {
      "url": "https://football-mcp-production.up.railway.app/mcp?key=YOUR_API_KEY"
    }
  }
}
```

### Cursor

Add to `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "endzoneapi": {
      "url": "https://football-mcp-production.up.railway.app/mcp?key=YOUR_API_KEY"
    }
  }
}
```

### VS Code (GitHub Copilot)

Add to `.vscode/mcp.json`:

```json
{
  "servers": {
    "endzoneapi": {
      "type": "streamable-http",
      "url": "https://football-mcp-production.up.railway.app/mcp?key=YOUR_API_KEY"
    }
  }
}
```

### Cline

Settings > MCP Servers > Add Remote Server:
- Name: `endzoneapi`
- URL: `https://football-mcp-production.up.railway.app/mcp?key=YOUR_API_KEY`

### Windsurf

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

```json
{
  "mcpServers": {
    "endzoneapi": {
      "serverUrl": "https://football-mcp-production.up.railway.app/mcp?key=YOUR_API_KEY"
    }
  }
}
```

## Available Tools

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

## Pricing

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

## Documentation

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