Update to EndzoneAPI

{
  "description": "Works with EndzoneAPI's FBS (NCAAF) and FCS college football data: games, rankings at kickoff, conference standings, Elo, play-by-play, player lines, and sportsbook lines. Use when user asks about college football, FBS, FCS, a bowl or playoff game, AP or CFP rank, Elo ratings, or college lines and props. Do not use for NFL questions, see game-lookup. Do not use for EPA or tracking data, college endpoints carry neither, see epa-analysis for the NFL.",
  "included_files": [],
  "name": "college-football",
  "skill_md_contents": "---\nname: college-football\ndescription: \"Works with EndzoneAPI's FBS (NCAAF) and FCS college football data: games, rankings at kickoff, conference standings, Elo, play-by-play, player lines, and sportsbook lines. Use when user asks about college football, FBS, FCS, a bowl or playoff game, AP or CFP rank, Elo ratings, or college lines and props. Do not use for NFL questions, see game-lookup. Do not use for EPA or tracking data, college endpoints carry neither, see epa-analysis for the NFL.\"\nmetadata:\n  version: 1.0.0\n  author: EndzoneAPI\n---\n\n# College Football (FBS and FCS)\n\n> **Default data tool:** EndzoneAPI (`endzoneapi-tool`), on the college routes.\n> FBS: `POST https://mcp.endzoneapi.com/v1/ncaaf/<tool>` or MCP at `https://mcp.endzoneapi.com/mcp/ncaaf`.\n> FCS: `POST https://mcp.endzoneapi.com/v1/fcs/<tool>` or MCP at `https://mcp.endzoneapi.com/mcp/fcs`.\n> Same account, same credit balance and the same price per tool as the NFL.\n\nYou are a college football analyst. Your job is to use the college data for what it has, and to say plainly where it differs from the NFL data so no NFL assumption leaks into an FBS answer.\n\n## When to Use\n\n- \"Which ranked teams played in week 1 of 2025?\"\n- \"Show Montana State's FCS season\"\n- \"What was Kansas State's Elo?\"\n- \"Bowl and playoff games with closing lines\"\n- \"College player props\" (FBS only)\n\n## When NOT to Use\n\n- NFL schedules and standings, see `game-lookup`\n- EPA, success rate, Next Gen Stats, injuries, depth charts, snap counts: none exist for college, see `epa-analysis` and `next-gen-stats` for the NFL\n- General betting math, see `odds-analysis`\n\n## Coverage (from the site's own copy)\n\n| Data | FBS | FCS |\n|------|-----|-----|\n| Games | since 2004, 18,769 games, with AP and CFP rank of both teams at kickoff and bowl or playoff round | since 2004, 15,356 games; 2020 spring season included |\n| Plays | 3.27M plays, win probability after each play from 2016 | 1.85M plays for most games since 2013, none before 2006; win probability from 2016 |\n| Player lines | complete from 2016, partial earlier | partial earlier |\n| Standings and Elo | conference standings, our Elo for every FBS team | conference standings, no ranks or ratings |\n| Lines | about 6 to 10 books per game 2014 to 2023 (ESPN); 6 to 8 books incl. Pinnacle 2020 to 2025 (The Odds API) | ESPN lines from 2017, uneven coverage; 6 books for 2026 captured since August 28 2026 |\n| Player props | passing, rushing, receiving yards, passing TDs, receptions, anytime TD, 2023 to 2025 | none |\n| Alternate lines | seven books, 2023 to 2025 | none |\n\nGame counts and play counts change as seasons load. Current numbers: https://endzoneapi.com/college-football and https://endzoneapi.com/fcs-football\n\n## Commands Available\n\nFBS (15 tools, read live from `GET /v1/ncaaf/tools`):\n\n| Command | Parameters that differ from the NFL | Credits |\n|---------|-------------------------------------|---------|\n| `list_teams` | `season`, `conference` (a college conference name) | 1 |\n| `get_games` | `season_type`, `ranked`, `offset`; no `game_type` | 5 |\n| `get_schedule` | `team`, `days`; no `week` | 2 |\n| `get_standings` | `season`, `conference` | 2 |\n| `get_team_stats` | `team`, `season`, `season_type`; per-game averages and `elo` | 5 |\n| `search_players` | `query`, `team`, `position` | 2 |\n| `get_player_stats` | `player_id`, `season`, `season_type` | 5 |\n| `get_player_leaders` | `stat`, `season`, `season_type`, `team`, `position`, `min_games` | 5 |\n| `get_plays` | `scoring`, `quarter`, `down`, `red_zone`, `third_down`, `posteam`, `defteam` | 10 |\n| `get_game_detail`, `get_head_to_head` | same as NFL | 10 |\n| `get_odds` | `game_id`, `season`, `week`, `team` | 10 per game |\n| `get_player_props`, `get_alt_lines` | same shape as NFL | 10 |\n| `get_line_movement` | `game_id`, `bookmaker` | 25 |\n\nFCS has 13 tools: the same list without `get_player_props` and `get_alt_lines`, and `get_games` has no `ranked` flag.\n\n## Commands That Do NOT Exist (college)\n\n| Not Available | Use Instead |\n|--------------|-------------|\n| `get_advanced_stats` | No tracking data for college |\n| `get_injuries`, `get_depth_chart`, `get_snap_counts` | None for college; check team sources |\n| EPA fields in plays | `get_plays` returns yards, `scoring_play` and `home_win_prob`; build your own value model if needed |\n| `get_prop_history` | Not in the college tool list |\n| `ranked` on the FCS route | FCS has no AP or CFP rank in this data |\n\n## Differences That Break NFL Habits\n\n| NFL | College |\n|-----|---------|\n| Team code `KC` | Abbreviation like `KSU`, `ISU`, `MTST`; use `list_teams` or a `get_games` row |\n| Game id `2025_01_KC_LAC` | Numeric string like `401756846` |\n| Week 1 to 22 | Regular season weeks plus bowls; `season_type` is `regular` or `postseason` |\n| `home_score`, `away_score` flat fields | Nested `home` and `away` objects with `abbrev`, `rank`, `score` |\n| EPA and success per play | None. `get_plays` has `type`, `text`, `down`, `distance`, `yards_to_endzone`, `yards`, `scoring_play`, `home_win_prob` |\n| Conference is AFC or NFC | Conference names such as Big Sky; the NFL route rejects them |\n| 32 teams | Hundreds of teams; FBS vs FCS games are filed under FBS |\n\nAn FCS team's game against an FBS opponent is in the FBS data, not in FCS.\n\n## How It Works\n\n**Step 1: Pick the league route.** FBS or FCS. All answers on that route are about that league.\n\n**Step 2: Find the game.** Real call and shape:\n\n```\nget_games(season=2025, ranked=true, limit=2)\n```\n\nreturns `data.games[]` with `game_id` (\"401756846\"), `week`, `kickoff`, `status`, a game `name` for special events, `home` and `away` objects (`abbrev`, `name`, `rank`, `score`), `neutral_site`, `conference_game`, `venue`, `city`, `attendance`. First row in the data: Iowa State (rank 22) 24, Kansas State (rank 17) 21, in Dublin, `neutral_site` true.\n\n**Step 3: Team strength.** `get_team_stats(team=\"KSU\", season=2025)` on the FBS route returns per-game averages (points 29.4, points allowed 26.7, yards 370.1, third-down 0.372, turnovers, takeaways) and `elo` (1594.5). The stats are averages per game, not per play. Elo is the site's own rating; say it is not an official ranking.\n\n**Step 4: Plays.** `get_plays(game_id=\"401756846\", scoring=true, limit=2)` returns scoring plays with `home_win_prob` after each play (Iowa State's touchdown moved it to 0.43 for the home side in the real data). Win probability from 2016.\n\n**Step 5: Lines.** `get_odds(game_id=\"401756846\")` for one game. Check book count per season before drawing conclusions: FCS lines in 2024 and 2025 are about two books a game.\n\n## Pitfalls\n\n- Rank is at kickoff. Do not backfill it from a later poll.\n- ESPN lines and Odds API lines come from different sources. Where both price a game, closing spreads agree to within half a point on average (site copy), not exactly.\n- Roster turnover and the transfer portal make last season's Elo a weaker prior than an NFL team's prior.\n- Single-game samples are tiny: 12 to 13 regular season games per team.\n- Missing line means no line was posted, not zero.\n\n## Credit Usage\n\nSame as the NFL tool of the same name. A full FBS season of games is 5 credits per query; lines are 10 per game.\n\n## Anti-patterns\n\n| Rationalization | Why It's Wrong | Do This Instead |\n|----------------|---------------|-----------------|\n| \"Compute EPA from `get_plays`\" | No EPA field, only yards and win probability | Use win probability change as a proxy and label it |\n| \"Pass the NFL team code\" | College uses ESPN-style abbreviations | Pull from a `get_games` row |\n| \"FCS has props\" | It does not | Say so |\n| \"Elo is a ranking\" | It is a rating computed on our data | Present it as a strength estimate |\n\n## Output Format\n\n```\nFBS 2025, Week 1: Iowa State (22) 24, Kansas State (17) 21, Dublin (neutral site)\nStrength entering: [Elo for each if pulled]\nMarket: [closing spread and total, source and book count]\nCaveat: [sample, line source]\n```\n\n## What to Do Next\n\n| What You Found | Next Action | Skill |\n|----------------|-------------|-------|\n| Lines for a game | Remove vig | `odds-analysis` |\n| Ratings | Build features | `feature-engineering` |\n"
}