EndzoneAPI MCP server
Commit Nov 13, 2026Provides NFL and college football data including play-by-play with EPA, player props, betting odds, and advanced player and team statistics.
Also known as noahowsh/endzoneapi-mcp, endzoneapi-mcp
- Stars
- 0
- Tools
- 20
- Downloads, 30 days
- —
- Latest version
- 1.1.6
- Last commit
- Nov 13, 2026
- License
- MIT
What is EndzoneAPI MCP?
EndzoneAPI provides NFL and college football data including play-by-play with EPA, player props, betting odds, and advanced player and team statistics. It exposes 20 tools, such as list_teams, get_standings, get_schedule.
Summary generated from the project's README
About EndzoneAPI MCP server
EndzoneAPI provides extensive football data for NFL and college football enthusiasts, including play-by-play information, player props, and betting odds. It offers deep statistical insights such as EPA per play, win probability, and Next Gen Stats. Users can access historical data dating back to 1999, covering everything from injury reports and depth charts to closing lines and advanced player metrics.
This is a remote MCP server hosted over Streamable HTTP, making it easy to connect to clients like Claude Desktop, Cursor, or Claude Code without local installation. Developers can integrate it by providing an API key via a URL parameter, an x-api-key header, or a Bearer token. The service includes 500 free monthly credits to allow for testing and initial development without requiring a credit card.
Beyond standard data retrieval, the server supports specialized skills for complex analysis. These tools allow an AI client to perform tasks like prop modeling, backtesting, and situational splits. With 18 distinct tools, including get_player_props and get_team_stats, it serves as a comprehensive backend for football analytics and prediction projects.
What you can do with it
- 1Analyze situational offensive efficiencyAsk the AI to identify which offenses performed best on third downs using EPA metrics.
- 2Retrieve historical betting linesRequest the closing spreads for a specific team across an entire season.
- 3Evaluate player prop performanceCompare a player's historical performance against their specific prop lines over time.
- 4Monitor team roster changesCheck current injury reports and depth charts for a specific team and week.
Written from the project's README. Every use case is checked against a quote from it.
How to install EndzoneAPI MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall EndzoneAPI MCP in Claude Code
$ claude mcp add --transport http endzoneapi-mcp https://mcp.endzoneapi.com/mcpInstall EndzoneAPI MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"endzoneapi-mcp": {
"url": "https://mcp.endzoneapi.com/mcp"
}
}
}Install EndzoneAPI MCP in VS Code
.vscode/mcp.json
{
"servers": {
"endzoneapi-mcp": {
"type": "http",
"url": "https://mcp.endzoneapi.com/mcp"
}
}
}Install EndzoneAPI MCP in VS Code CLI
$ code --add-mcp '{"name":"endzoneapi-mcp","type":"http","url":"https://mcp.endzoneapi.com/mcp"}'Install EndzoneAPI MCP in Codex
$ codex mcp add endzoneapi-mcp --url https://mcp.endzoneapi.com/mcpInstall EndzoneAPI MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.endzoneapi-mcp] url = "https://mcp.endzoneapi.com/mcp"
Install EndzoneAPI MCP in Gemini CLI
$ gemini mcp add -s user --transport http endzoneapi-mcp https://mcp.endzoneapi.com/mcpInstall EndzoneAPI MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"endzoneapi-mcp": {
"url": "https://mcp.endzoneapi.com/mcp",
"type": "http"
}
}
}EndzoneAPI MCP tools 20
Detected from the READMElist_teamsget_standingsget_schedulesearch_playersget_injuriesget_depth_chartget_gamesget_team_statsget_player_statsget_player_leadersget_snap_countsget_advanced_stats
| list_teams | — | |
| get_standings | — | |
| get_schedule | — | |
| search_players | — | |
| get_injuries | — | |
| get_depth_chart | — | |
| get_games | — | |
| get_team_stats | — | |
| get_player_stats | — | |
| get_player_leaders | — | |
| get_snap_counts | — | |
| get_advanced_stats | — |
Show all 20 toolsShow fewer tools
get_playsget_oddsget_game_detailget_head_to_headget_line_movementget_player_propsget_prop_historyget_alt_lines
| get_plays | — | |
| get_odds | — | |
| get_game_detail | — | |
| get_head_to_head | — | |
| get_line_movement | — | |
| get_player_props | — | |
| get_prop_history | — | |
| get_alt_lines | — |
Configuration
ENDZONEAPI_API_KEY
| Name | Description | |
|---|---|---|
| ENDZONEAPI_API_KEY | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablenoahowsh/endzoneapi-mcp is public and reachablegithub.com/noahowsh/endzoneapi-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-19github.com/noahowsh/endzoneapi-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model20 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 34 msPass
README
View on GitHubEndzoneAPI MCP server
The football data API. Play-by-play with EPA and win probability, player and team stats, schedules, injuries, depth charts and closing lines for every NFL game since 1999. REST API and MCP server. 500 free credits every month, no card.
Website: https://endzoneapi.com · Docs: https://endzoneapi.com/docs · Get a key: https://endzoneapi.com/signup
You: "What was the closing spread for every Chiefs game last season?"
Claude: [calls get_games -> one call, every game with spread, total and moneyline]
You: "Which offenses had the best EPA per play on third down in 2025?"
Claude: [calls get_plays with third_down filter -> EPA already attached]
Skills
16 free Claude skills turn Claude into a football analyst wired to these tools: EPA per play and success rate, Next Gen Stats, weekly player stats, odds and devigging, prop modeling, college football and FCS, and honest backtesting. They are plain markdown folders.
git clone https://github.com/noahowsh/endzoneapi-mcp.git
Or install them as a Claude Code plugin:
/plugin marketplace add noahowsh/endzoneapi-mcp
/plugin install endzoneapi-skills@endzoneapi
Or with the skills CLI: npx skills add noahowsh/endzoneapi-mcp.
Point Claude (Claude Code, or any client that loads skills) at the skills/ folder, and connect the MCP server above so the skills can call live data. The dispatch skill routes a request to the right two or three skills. Full list: skills/README.md
You: "Which offenses were best on third down in 2025, and how many plays is that based on?"
Claude: [loads epa-analysis + endzoneapi-tool, calls get_plays with third_down and a limit that
holds the split, reports EPA per play, success rate and the play count]
Useful pages
- Odds this week: https://endzoneapi.com/odds
- Player props this week (best price per player across books): https://endzoneapi.com/props
- Props guides: receiving yards history, anytime touchdown history, passing yards history
- Guides: https://endzoneapi.com/guides
- Docs: https://endzoneapi.com/docs
- Pricing: https://endzoneapi.com/pricing
- Data coverage: https://endzoneapi.com/data
- College football (FBS): https://endzoneapi.com/college-football
- FCS football: https://endzoneapi.com/fcs-football
- Compare: ESPN API alternative, nflfastR API, SportsDataIO alternative
Python
The official Python client is on PyPI: endzoneapi.
pip install endzoneapi
export ENDZONEAPI_API_KEY=sk_live_...
from endzoneapi import Client, to_dataframe
client = Client()
print(client.get_player_props(game_id="2025_01_KC_LAC", estimate_only=True))
props = client.get_player_props(
game_id="2025_01_KC_LAC",
market="player_pass_yds",
bookmaker="draftkings",
)
df = to_dataframe(props, key="props")
print(df[["player_name", "line", "over_odds", "under_odds"]])
Typed errors for a bad key, no credits left, not found and rate limits, automatic retries, and to_dataframe for pandas.
Quick start
This is a hosted (remote) MCP server over Streamable HTTP. There is nothing to install.
Claude Code
claude mcp add --transport http endzoneapi "https://mcp.endzoneapi.com/mcp?key=YOUR_API_KEY"
Claude Desktop, Cursor and other clients
{
"mcpServers": {
"endzoneapi": {
"url": "https://mcp.endzoneapi.com/mcp?key=YOUR_API_KEY"
}
}
}
The key can also be sent as an x-api-key header or Authorization: Bearer. Connecting and listing tools works without a key; calling a tool needs one.
REST
curl -X POST https://mcp.endzoneapi.com/v1/list_teams -H "x-api-key: YOUR_API_KEY"
Every tool is POST /v1/{tool} with a JSON body.
Tools (18)
| Tool | What it returns |
|---|---|
list_teams |
All 32 teams with conference, division, colours, and logos |
get_standings |
Standings and playoff seeding by the NFL tiebreaking procedure, with the step that decided each rank |
get_schedule |
Upcoming games by week or for the next N days |
search_players |
Find players by name, team, or position |
get_injuries |
Injury report by team and week with practice and game status |
get_depth_chart |
Team depth chart by week |
get_games |
Query games by season, week, team, date, type, or status, with closing lines |
get_team_stats |
Team totals and per-week lines with EPA, success rate, and situational splits |
get_player_stats |
Weekly and season stat lines for one player: passing, rushing, receiving, defense, kicking, fantasy |
get_player_leaders |
Leaderboard for any stat, filtered by position, team, and season |
get_snap_counts |
Offensive, defensive, and special-teams snaps and shares by game or player |
get_advanced_stats |
Next Gen Stats tracking metrics and Pro Football Reference advanced stats |
get_plays |
Play-by-play with EPA, win probability, situation filters, and optional FTN charting |
get_odds |
Odds by game with bookmaker filters |
get_game_detail |
Full game detail with team stats, starting QBs, odds, weather, and officials |
get_head_to_head |
Matchup history with win/loss records and margins |
get_line_movement |
Time-series odds grouped by bookmaker |
get_player_props |
Player prop lines by sportsbook, opening and closing: passing, rushing and receiving yards, TDs, receptions, anytime TD |
get_prop_history |
One player against his prop line over time for one market, with hit rate |
get_alt_lines |
Alternate spreads and totals by sportsbook, every point on each ladder with its price |
Data
- Play-by-play for every game since 1999 with EPA, win probability and model columns
- Closing spread, total and moneyline for every game since 1999; per-book odds from 2020 (up to 8 books, hourly in season from 2026)
- Player prop lines from 2023, captured live before every game
- Weekly player and team stats, injuries (2009+), depth charts (2001+), snap counts (2012+), Next Gen Stats, FTN charting (2022+)
Coverage by season, read live from the database: https://endzoneapi.com/data/historical-odds, https://endzoneapi.com/data/player-props and https://endzoneapi.com/data/play-by-play
Used by
NoPunt, our NFL predictions site, runs on this API.
- nfl-props-backtest: a season of NFL player props against what happened (calibration, over rates, line moves, anytime TD prices), in Python and R.
Pricing
500 free credits every month, no card. Plans: Starter $19/mo (10,000 credits), Pro $49/mo (30,000), Scale $149/mo (125,000). Wallet top-ups from $5, kept while your account is open. https://endzoneapi.com/pricing
Attribution
Stats, schedules and play-by-play are from nflverse (CC BY 4.0), modified and combined with our own models. Not affiliated with the NFL or any team.
License
MIT for the contents of this repository. Data terms as above.
Use with Codex
Add this repo as a Codex plugin marketplace, then install the plugin:
codex plugin marketplace add noahowsh/endzoneapi-mcp
Then open the plugin directory in Codex and install endzoneapi-skills from the endzoneapi marketplace. The plugin bundles the skills in skills/ and the EndzoneAPI MCP server (https://mcp.endzoneapi.com/mcp). Set your key first (free at https://endzoneapi.com/signup):
export ENDZONEAPI_API_KEY=your_key
Codex sends it as a bearer token.
Use with Gemini CLI
export ENDZONEAPI_API_KEY=your_key
gemini extensions install https://github.com/noahowsh/endzoneapi-mcp
The extension adds the EndzoneAPI MCP server (https://mcp.endzoneapi.com/mcp) and sends the key in the x-api-key header. Get a free key (500 credits a month) at https://endzoneapi.com/signup.
EndzoneAPI MCP questions
How do I add EndzoneAPI MCP to Claude Code?
Run claude mcp add --transport http endzoneapi-mcp https://mcp.endzoneapi.com/mcp in your terminal. Add --scope user to make it available in every project.
How do I add EndzoneAPI MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does EndzoneAPI MCP provide?
It exposes 20 tools, including list_teams, get_standings, get_schedule, search_players, get_injuries.
How much does EndzoneAPI cost?
There is a free tier providing 500 credits every month without a credit card, alongside paid plans starting at $19/mo.
What kind of football data is available?
The API offers play-by-play data with EPA and win probability, player and team stats, schedules, injuries, depth charts, and closing lines dating back to 1999.
Can I use EndzoneAPI with Python?
Yes, there is an official Python client available on PyPI called endzoneapi.