# EndzoneAPI

> The football data API. 17 football data tools for AI agents. REST API + MCP server.

Full reference with response shapes: https://endzoneapi.com/llms-full.txt
MCP server setup: https://endzoneapi.com/llms-install.md
Tool catalogue with JSON Schema: https://football-mcp-production.up.railway.app/v1/tools

## Quick Start

- API base URL: https://football-mcp-production.up.railway.app
- Auth: `Authorization: Bearer YOUR_API_KEY` or `x-api-key: YOUR_API_KEY`
- MCP server: `https://football-mcp-production.up.railway.app/mcp?key=YOUR_API_KEY`
- 500 free credits on signup, no credit card required
- REST API responses include `X-Credits-Used` and `X-Credits-Remaining` headers
- Seasons: 4-digit season year, the year the regular season starts (2025 for the 2025-26 season). Team codes like KC, BUF, PHI, SF. Game ids like 2025_01_KC_BUF (season_week_away_home).

## Which Tool Should I Use?

### Static reference
- All 32 teams with conference, division, colours, and logos -> list_teams (1 cr)

### Basic lookup
- Standings and playoff seeding by the NFL tiebreaking procedure, with the step that decided each rank -> get_standings (2 cr)
- Upcoming games by week or for the next N days -> get_schedule (2 cr)
- Find players by name, team, or position -> search_players (2 cr)
- Injury report by team and week with practice and game status -> get_injuries (2 cr)
- Team depth chart by week -> get_depth_chart (2 cr)

### Stats + aggregation
- Team totals and per-week lines with EPA, success rate, and situational splits -> get_team_stats (5 cr)
- Query games by season, week, team, date, type, or status, with closing lines -> get_games (5 cr)
- Weekly and season stat lines for one player: passing, rushing, receiving, defense, kicking, fantasy -> get_player_stats (5 cr)
- Leaderboard for any stat, filtered by position, team, and season -> get_player_leaders (5 cr)
- Offensive, defensive, and special-teams snaps and shares by game or player -> get_snap_counts (5 cr)
- Next Gen Stats tracking metrics and Pro Football Reference advanced stats -> get_advanced_stats (5 cr)

### Multi-table
- Full game detail with team stats, starting QBs, odds, weather, and officials -> get_game_detail (10 cr)
- Matchup history with win/loss records and margins -> get_head_to_head (10 cr)
- Play-by-play with EPA, win probability, situation filters, and optional FTN charting -> get_plays (10 cr)
- Odds by game with bookmaker filters -> get_odds (10 cr)

### Time-series
- Time-series odds grouped by bookmaker -> get_line_movement (25 cr)

## Intents

- "I want a list of all teams and their codes" -> list_teams
- "Who is leading the AFC East?" -> get_standings
- "What games are on this week?" -> get_schedule
- "Give me every game from the 2024 season with closing lines" -> get_games
- "What happened in the Chiefs vs Chargers opener?" -> get_game_detail
- "How have the Bills done against the Chiefs recently?" -> get_head_to_head
- "Find Patrick Mahomes' player id" -> search_players
- "Show me a player's weekly stat lines this season" -> get_player_stats
- "Which quarterbacks have the best EPA?" -> get_player_leaders
- "How efficient is this team's offense week to week?" -> get_team_stats
- "How much separation is this receiver getting?" -> get_advanced_stats
- "How often was this quarterback pressured?" -> get_advanced_stats
- "How does this offense do off play action?" -> get_plays
- "Which plays used pre-snap motion?" -> get_plays
- "Who is out this week for Kansas City?" -> get_injuries
- "Who is the starting left tackle?" -> get_depth_chart
- "How many snaps did the rookie play?" -> get_snap_counts
- "Give me all third-down plays for an offense" -> get_plays
- "What is the spread on the Chiefs game?" -> get_odds
- "How did the line move before kickoff?" -> get_line_movement

## Pages

- [Docs](https://endzoneapi.com/docs): every endpoint, with parameters and a live example response.
- [Data changelog](https://endzoneapi.com/changelog): when each dataset was last refreshed and what it runs through, read from the database.
- [Data atlas](https://endzoneapi.com/docs/atlas): what exists, which endpoints expose it, and where coverage is partial.
- [Teams](https://endzoneapi.com/teams): a page per club with its record, season figures and recent games.
- [Pricing](https://endzoneapi.com/pricing): credits per call and what a plan includes.
- [Sign up](https://endzoneapi.com/signup): 500 free credits, no card.

### Endpoint pages

- [list_teams](https://endzoneapi.com/docs/list-teams): All 32 teams with conference, division, colours, and logos
- [get_standings](https://endzoneapi.com/docs/get-standings): Standings and playoff seeding by the NFL tiebreaking procedure, with the step that decided each rank
- [get_team_stats](https://endzoneapi.com/docs/get-team-stats): Team totals and per-week lines with EPA, success rate, and situational splits
- [get_games](https://endzoneapi.com/docs/get-games): Query games by season, week, team, date, type, or status, with closing lines
- [get_schedule](https://endzoneapi.com/docs/get-schedule): Upcoming games by week or for the next N days
- [get_game_detail](https://endzoneapi.com/docs/get-game-detail): Full game detail with team stats, starting QBs, odds, weather, and officials
- [get_head_to_head](https://endzoneapi.com/docs/get-head-to-head): Matchup history with win/loss records and margins
- [search_players](https://endzoneapi.com/docs/search-players): Find players by name, team, or position
- [get_player_stats](https://endzoneapi.com/docs/get-player-stats): Weekly and season stat lines for one player: passing, rushing, receiving, defense, kicking, fantasy
- [get_player_leaders](https://endzoneapi.com/docs/get-player-leaders): Leaderboard for any stat, filtered by position, team, and season
- [get_injuries](https://endzoneapi.com/docs/get-injuries): Injury report by team and week with practice and game status
- [get_depth_chart](https://endzoneapi.com/docs/get-depth-chart): Team depth chart by week
- [get_snap_counts](https://endzoneapi.com/docs/get-snap-counts): Offensive, defensive, and special-teams snaps and shares by game or player
- [get_plays](https://endzoneapi.com/docs/get-plays): Play-by-play with EPA, win probability, situation filters, and optional FTN charting
- [get_advanced_stats](https://endzoneapi.com/docs/get-advanced-stats): Next Gen Stats tracking metrics and Pro Football Reference advanced stats
- [get_odds](https://endzoneapi.com/docs/get-odds): Odds by game with bookmaker filters
- [get_line_movement](https://endzoneapi.com/docs/get-line-movement): Time-series odds grouped by bookmaker

### Metric definitions

- [EPA](https://endzoneapi.com/glossary/epa): How much a single play changed the number of points its team could expect to score next — the closest thing football has to a universal currency.
- [Success rate](https://endzoneapi.com/glossary/success-rate): The share of plays that gained enough to keep the drive on schedule. EPA's blunt, stable cousin.
- [Win probability](https://endzoneapi.com/glossary/win-probability): The chance a team wins from the state the game is in right now.
- [CPOE](https://endzoneapi.com/glossary/cpoe): How often a passer completes throws compared with what the throw itself justified.
- [Air yards](https://endzoneapi.com/glossary/air-yards): How far downfield the ball travelled before it was caught or fell — opportunity, measured before the catch.
- [Snap share](https://endzoneapi.com/glossary/snap-share): The share of his team's offensive or defensive snaps a player was on the field for. The first thing to check before anything else.
- [Yards after catch](https://endzoneapi.com/glossary/yards-after-catch): Yards a receiver gains once the ball is in his hands, as opposed to the yards the throw travelled.
- [Time to throw](https://endzoneapi.com/glossary/time-to-throw): Seconds from the snap until the ball leaves the quarterback's hand, measured by tracking rather than charted by hand.
- [Closing line](https://endzoneapi.com/glossary/closing-line): The last price a market offered before kickoff, and the most accurate public forecast of a game that exists.
- [Point differential](https://endzoneapi.com/glossary/point-differential): Points scored minus points allowed. A better guide to a team's next game than its record is.
- [Passer rating](https://endzoneapi.com/glossary/passer-rating): The league's own quarterback formula, built from four rate stats and capped at 158.3.
- [Win probability added](https://endzoneapi.com/glossary/win-probability-added): How much a single play moved a team's chance of winning that specific game — the change in win probability, play by play.

### By what you are building

- [Analysts and researchers](https://endzoneapi.com/for/analysts): 1.2 million plays with expected points and win probability, plus Next Gen Stats tracking and FTN charting in the same database.
- [Bettors and modellers](https://endzoneapi.com/for/bettors): Every game carries a closing spread, and the play-by-play underneath is already priced in EPA and win probability.
- [Developers](https://endzoneapi.com/for/developers): REST for code, MCP for Claude and Cursor — 17 tools, one key, no scraping.
- [Fantasy players](https://endzoneapi.com/for/fantasy): Snap shares, air yards, depth charts and injury status — the leading indicators, not last week's box score.