{"openapi":"3.1.0","info":{"title":"Blaze Sports Intel — Multi-Sport MCP","version":"4.0.0","description":"Live scores, standings, rankings, schedules, box scores, and advanced analytics across MLB, NFL, NBA, college football (FBS), and NCAA Division I college baseball. Baseball includes sabermetric tooling (wOBA, wRC+, FIP, ERA-, BABIP, ISO) via BSI Savant. Data sources: Highlightly (baseball), SportsDataIO primary with ESPN fallback (all sports). Responses include a `meta` block with source attribution and fetch timestamp. Every response carries an `X-Request-Id` header for tracing.","contact":{"name":"Blaze Sports Intel","url":"https://blazesportsintel.com"},"license":{"name":"Usage subject to BSI terms","url":"https://blazesportsintel.com/terms"}},"servers":[{"url":"https://sabermetrics.blazesportsintel.com","description":"Production"}],"tags":[{"name":"MCP","description":"Model Context Protocol (JSON-RPC 2.0) endpoint for AI clients"},{"name":"Scores","description":"Live scores and game results"},{"name":"Standings","description":"Conference and national standings"},{"name":"Teams","description":"Per-team sabermetrics and schedules"},{"name":"Players","description":"Player search and stats"},{"name":"Analytics","description":"Sabermetric leaderboards and indices"}],"paths":{"/health":{"get":{"tags":["MCP"],"summary":"Liveness check","responses":{"200":{"description":"Service is healthy","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"ok"},"service":{"type":"string"},"version":{"type":"string"},"timestamp":{"type":"string","format":"date-time"},"endpoints":{"type":"integer"},"highlightly":{"type":"boolean"}}}}}}}}},"/mcp":{"post":{"tags":["MCP"],"summary":"JSON-RPC 2.0 MCP endpoint","description":"AI clients (Claude Desktop, Cursor, Cline, custom agents) call this endpoint with the MCP protocol. Supports `initialize`, `tools/list`, `tools/call`, `resources/list`, `prompts/list`. See https://modelcontextprotocol.io for the protocol spec.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"integer"},{"type":"null"}]},"method":{"type":"string","enum":["initialize","tools/list","tools/call"]},"params":{"type":"object"}}},"examples":{"initialize":{"value":{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"claude-desktop","version":"1.0"}}}},"listTools":{"value":{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}},"callStandings":{"value":{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"bsi_get_standings","arguments":{"conference":"SEC"}}}}}}}},"responses":{"200":{"description":"JSON-RPC response (success or error)"},"400":{"description":"Invalid JSON-RPC request"},"429":{"description":"Rate limited (30 req/min per token)"}}}},"/v1/scoreboard":{"get":{"tags":["Scores"],"summary":"Live scores and final game results","parameters":[{"name":"date","in":"query","schema":{"type":"string","example":"2026-04-12"}},{"name":"conference","in":"query","schema":{"type":"string","example":"SEC"}}],"responses":{"200":{"description":"Scoreboard with games[] and meta"}}}},"/v1/standings":{"get":{"tags":["Standings"],"summary":"Conference standings","parameters":[{"name":"conference","in":"query","schema":{"type":"string","example":"SEC"}}],"responses":{"200":{"description":"Standings grouped by conference"}}}},"/v1/rankings":{"get":{"tags":["Standings"],"summary":"National Top 25","responses":{"200":{"description":"Top 25 rankings with movement"}}}},"/v1/players":{"get":{"tags":["Players"],"summary":"Player search and stats","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string"}},{"name":"team","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Player object or null"}}}},"/v1/teams/{team}/stats":{"get":{"tags":["Teams"],"summary":"Team sabermetrics","parameters":[{"name":"team","in":"path","required":true,"schema":{"type":"string","example":"texas"}}],"responses":{"200":{"description":"wOBA, wRC+, FIP, ERA-, BABIP, ISO, top_hitters, top_pitchers"}}}},"/v1/teams/{team}/schedule":{"get":{"tags":["Teams"],"summary":"Team schedule","parameters":[{"name":"team","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Past and upcoming games"}}}},"/v1/leaderboard":{"get":{"tags":["Analytics"],"summary":"Sabermetric leaderboard","parameters":[{"name":"metric","in":"query","schema":{"type":"string","enum":["woba","wrc_plus","ops_plus","fip","era_minus","babip","iso"]}},{"name":"type","in":"query","schema":{"type":"string","enum":["batting","pitching"]}},{"name":"limit","in":"query","schema":{"type":"integer","maximum":50,"default":20}},{"name":"conference","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Ranked leaders"}}}},"/v1/power-index":{"get":{"tags":["Analytics"],"summary":"Conference Power Index","responses":{"200":{"description":"Conferences ranked by SOS-adjusted win%"}}}},"/v1/matches/{id}":{"get":{"tags":["Scores"],"summary":"Match detail with venue, weather, predictions","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Full match detail"}}}}},"components":{"schemas":{"Meta":{"type":"object","properties":{"source":{"type":"string","example":"highlightly"},"fetched_at":{"type":"string","format":"date-time"},"timezone":{"type":"string","example":"America/Chicago"}}},"McpTool":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"inputSchema":{"type":"object"},"annotations":{"type":"object","properties":{"readOnlyHint":{"type":"boolean"},"destructiveHint":{"type":"boolean"},"idempotentHint":{"type":"boolean"},"openWorldHint":{"type":"boolean"}}}}}}},"x-mcp-tools":{"bsi_get_scoreboard":{"type":"object","properties":{"date":{"type":"string","description":"Date in YYYY-MM-DD format. Defaults to today (America/Chicago)."},"conference":{"type":"string","description":"Filter by conference (e.g., \"SEC\", \"Big 12\", \"ACC\"). Optional."}},"required":[],"description":"Get today's college baseball scores and game results. Returns live and final games with team names, scores, venue, and game status. Covers all 330 D1 teams."},"bsi_get_standings":{"type":"object","properties":{"conference":{"type":"string","description":"Conference name (e.g., \"SEC\", \"Big 12\", \"ACC\", \"Big Ten\"). Optional — omit for all conferences."}},"required":[],"description":"Get current college baseball conference standings including wins, losses, win percentage, runs scored, runs allowed, run differential, streak, and games back."},"bsi_get_rankings":{"type":"object","properties":{},"required":[],"description":"Get the latest national college baseball rankings (Top 25). Returns rank, team, record, and trend."},"bsi_get_team_sabermetrics":{"type":"object","properties":{"team":{"type":"string","description":"Team name or slug (e.g., \"texas\", \"tennessee\", \"lsu\")."}},"required":["team"],"description":"Get advanced sabermetric batting and pitching metrics for a college baseball team: wOBA, wRC+, FIP, ERA-, BABIP, ISO, and more."},"bsi_get_leaderboard":{"type":"object","properties":{"metric":{"type":"string","description":"Metric to rank by: \"woba\", \"wrc_plus\", \"ops_plus\", \"fip\", \"era_minus\", \"babip\", \"iso\". Default: \"woba\".","enum":["woba","wrc_plus","ops_plus","fip","era_minus","babip","iso"]},"type":{"type":"string","description":"\"batting\" or \"pitching\". Default: \"batting\".","enum":["batting","pitching"]},"limit":{"type":"number","description":"Number of results to return. Default: 20, max: 50."},"conference":{"type":"string","description":"Filter by conference. Optional."}},"required":[],"description":"Get the top college baseball hitters or pitchers by an advanced metric. Returns a ranked leaderboard with player names, teams, and stat values."},"bsi_get_conference_power_index":{"type":"object","properties":{},"required":[],"description":"Get the Conference Power Index — a ranking of D1 conferences by average win percentage and run differential. Uses Highlightly standings data when available."},"bsi_get_player_stats":{"type":"object","properties":{"player":{"type":"string","description":"Player name (e.g., \"Jac Caglianone\", \"Charlie Condon\")."},"team":{"type":"string","description":"Team name to disambiguate when multiple players share a name. Optional."}},"required":["player"],"description":"Search for a college baseball player by name and get their stats, position, team, and headshot. Searches BSI sabermetric data."},"bsi_get_team_schedule":{"type":"object","properties":{"team":{"type":"string","description":"Team name or slug (e.g., \"texas\", \"lsu\", \"florida-state\")."}},"required":["team"],"description":"Get the full schedule for a college baseball team, including past results and upcoming games."},"bsi_get_match_detail":{"type":"object","properties":{"matchId":{"type":"string","description":"Highlightly match ID (from scoreboard results). e.g., \"993144\"."}},"required":["matchId"],"description":"Get detailed information about a specific college baseball game including venue, weather, win predictions, play-by-play, and team stats. Use a match ID from the scoreboard."},"bsi_search_intel":{"type":"object","properties":{"query":{"type":"string","description":"Natural-language search query (e.g., \"Texas Longhorns baseball weekend series recap\", \"Charlie Condon draft stock 2026\")."},"limit":{"type":"number","description":"Max results to return. Default 5, min 1, max 10."},"domains":{"type":"array","items":{"type":"string"},"description":"Optional allowlist of domains to search within. Defaults to trusted college-baseball sources. Pass [] to search the open web."}},"required":["query"],"description":"Search the open web for college-baseball news, scouting reports, beat-writer coverage, and analytical commentary. Complements the stats tools — use this when a question needs narrative context, not just numbers. Defaults to trusted college-baseball domains (d1baseball.com, baseballamerica.com, ESPN, NCAA.com, etc.). Provider: Exa (primary) with Tavily fallback."},"bsi_get_mlb_scoreboard":{"type":"object","properties":{"date":{"type":"string","description":"Date in YYYY-MM-DD format. Defaults to today (America/Chicago)."}},"required":[],"description":"Get MLB scores and game results for a given date. Returns live and final games with team names, scores, venue, and game status. Data source: SportsDataIO primary with ESPN fallback."},"bsi_get_mlb_standings":{"type":"object","properties":{},"required":[],"description":"Get current MLB standings including wins, losses, win percentage, and division records. Data source: SportsDataIO primary with ESPN fallback."},"bsi_get_mlb_team":{"type":"object","properties":{"teamId":{"type":"string","description":"ESPN MLB team ID (e.g., \"24\" for St. Louis Cardinals, \"3\" for Los Angeles Dodgers)."}},"required":["teamId"],"description":"Get MLB team detail (record, venue, roster) by ESPN team ID."},"bsi_get_mlb_game":{"type":"object","properties":{"gameId":{"type":"string","description":"MLB game ID (SDIO numeric ID or ESPN event ID from the scoreboard)."}},"required":["gameId"],"description":"Get detailed MLB game information including box score, play-by-play summary, and team stats."},"bsi_get_mlb_leaders":{"type":"object","properties":{"category":{"type":"string","enum":["batting","pitching"],"description":"Stat category. Default: \"batting\"."},"stat":{"type":"string","description":"Specific stat within the category (e.g., \"avg\", \"hr\", \"rbi\" for batting; \"era\", \"wins\", \"k\" for pitching). Optional."}},"required":[],"description":"Get MLB statistical leaders by category. Returns top players with supporting stats. Data source: ESPN."},"bsi_get_nfl_scoreboard":{"type":"object","properties":{"date":{"type":"string","description":"Date in YYYY-MM-DD format. Defaults to today (America/Chicago)."}},"required":[],"description":"Get NFL scores and game results for a given date. Returns live, upcoming, and final games with team names, scores, venue, and game status. Data source: ESPN primary with SportsDataIO fallback."},"bsi_get_nfl_standings":{"type":"object","properties":{},"required":[],"description":"Get current NFL standings by division and conference including wins, losses, ties, and win percentage."},"bsi_get_nfl_team":{"type":"object","properties":{"teamId":{"type":"string","description":"ESPN NFL team ID (e.g., \"10\" for Tennessee Titans, \"24\" for Los Angeles Chargers)."}},"required":["teamId"],"description":"Get NFL team detail (record, venue, roster) by ESPN team ID."},"bsi_get_nfl_game":{"type":"object","properties":{"gameId":{"type":"string","description":"NFL game ID (ESPN event ID from the scoreboard)."}},"required":["gameId"],"description":"Get detailed NFL game information including box score, scoring summary, and team stats."},"bsi_get_nfl_leaders":{"type":"object","properties":{},"required":[],"description":"Get NFL statistical leaders across passing, rushing, receiving, and defensive categories. Data source: ESPN."},"bsi_get_nba_scoreboard":{"type":"object","properties":{"date":{"type":"string","description":"Date in YYYY-MM-DD format. Defaults to today (America/Chicago)."}},"required":[],"description":"Get NBA scores and game results for a given date. Returns live, upcoming, and final games with team names, scores, venue, and game status. Data source: ESPN primary with SportsDataIO fallback."},"bsi_get_nba_standings":{"type":"object","properties":{},"required":[],"description":"Get current NBA standings by conference including wins, losses, win percentage, and games back."},"bsi_get_nba_team":{"type":"object","properties":{"teamId":{"type":"string","description":"ESPN NBA team ID (e.g., \"13\" for LA Lakers, \"2\" for Boston Celtics)."}},"required":["teamId"],"description":"Get NBA team detail (record, venue, roster) by ESPN team ID."},"bsi_get_nba_game":{"type":"object","properties":{"gameId":{"type":"string","description":"NBA game ID (ESPN event ID from the scoreboard)."}},"required":["gameId"],"description":"Get detailed NBA game information including box score, quarter scores, and team stats."},"bsi_get_nba_leaders":{"type":"object","properties":{},"required":[],"description":"Get NBA statistical leaders across points, rebounds, assists, and efficiency categories. Data source: ESPN."},"bsi_get_cfb_scoreboard":{"type":"object","properties":{"date":{"type":"string","description":"Date in YYYY-MM-DD format. Defaults to today (America/Chicago)."}},"required":[],"description":"Get college football (FBS) scores and game results for a given date. Returns live, upcoming, and final games with team names, scores, venue, and game status. Data source: ESPN primary with SportsDataIO fallback."},"bsi_get_cfb_standings":{"type":"object","properties":{},"required":[],"description":"Get current college football standings by conference including wins, losses, win percentage, and conference records."},"bsi_get_cfb_rankings":{"type":"object","properties":{},"required":[],"description":"Get the latest college football rankings (AP Top 25, Coaches Poll, CFP). Returns rank, team, record, and trend."},"bsi_get_cfb_team":{"type":"object","properties":{"teamId":{"type":"string","description":"ESPN CFB team ID (e.g., \"251\" for Texas Longhorns, \"99\" for LSU Tigers)."}},"required":["teamId"],"description":"Get college football team detail (record, venue, roster) by ESPN team ID."},"bsi_get_cfb_game":{"type":"object","properties":{"gameId":{"type":"string","description":"CFB game ID (ESPN event ID from the scoreboard)."}},"required":["gameId"],"description":"Get detailed college football game information including box score, scoring summary, and team stats."},"bsi_get_cfb_transfer_portal":{"type":"object","properties":{},"required":[],"description":"Get the latest college football transfer portal entries and commitments. Updated daily."}}}