{"sport":"mlb","brand":"FastballAPI","base_url":"https://mcp.fastballapi.com","mcp_url":"https://mcp.fastballapi.com/mcp","tools":[{"name":"list_teams","description":"Use to find team ids and abbreviations for a season (default: the latest). Every other tool takes a team as an id or abbreviation. Costs 1 credit.","credits":1,"category":"Static reference","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"season":{"description":"Season (a year, e.g. 2025; default: the latest).","type":["number","string"]},"league":{"description":"League. Defaults to mlb. One of: mlb, ncaabase.","type":"string","enum":["mlb","ncaabase"]}},"additionalProperties":false}},{"name":"get_games","description":"Use to list games with runs, hits and errors by season, date, date range or team, newest first. For upcoming games with lines use get_schedule; for one game's box score use get_game. Costs 2 credits.","credits":2,"category":"Basic lookup","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"season":{"description":"Season (a year, e.g. 2025; default: the latest).","type":["number","string"]},"season_type":{"description":"regular or postseason (default both).","type":"string","enum":["regular","postseason"]},"team":{"description":"Team id or abbreviation.","type":"string"},"date":{"description":"One date, YYYY-MM-DD (US Eastern).","type":"string"},"from":{"description":"From date, YYYY-MM-DD.","type":"string"},"to":{"description":"To date, YYYY-MM-DD.","type":"string"},"status":{"type":"string","enum":["scheduled","final"]},"limit":{"description":"Max games (default 50).","type":"integer","minimum":1,"maximum":200},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991},"league":{"description":"League. Defaults to mlb. One of: mlb, ncaabase.","type":"string","enum":["mlb","ncaabase"]}},"additionalProperties":false}},{"name":"get_schedule","description":"Use for upcoming games (next 1-30 days, default 7) with the median line across posted sportsbooks: moneylines, run line and total. For every book's line use get_odds. Costs 2 credits.","credits":2,"category":"Basic lookup","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"days":{"type":"integer","minimum":1,"maximum":30},"team":{"description":"Team id or abbreviation.","type":"string"},"league":{"description":"League. Defaults to mlb. One of: mlb, ncaabase.","type":"string","enum":["mlb","ncaabase"]}},"additionalProperties":false}},{"name":"get_game","description":"Use for one game in full: line score, every batter's and pitcher's line, each sportsbook's opening and closing line, and the win-probability range. For every plate appearance use get_plate_appearances. Costs 5 credits.","credits":5,"category":"Stats + aggregation","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"game_id":{"type":"string","description":"ESPN game id, from get_games or get_schedule."},"league":{"description":"League. Defaults to mlb. One of: mlb, ncaabase.","type":"string","enum":["mlb","ncaabase"]}},"required":["game_id"],"additionalProperties":false}},{"name":"get_standings","description":"Use for a season's regular-season standings computed from every final game: record, home and away, last 10, runs scored and allowed, run differential and Pythagorean win percentage. Costs 2 credits.","credits":2,"category":"Basic lookup","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"season":{"description":"Season (a year, e.g. 2025; default: the latest).","type":["number","string"]},"league":{"description":"League. Defaults to mlb. One of: mlb, ncaabase.","type":"string","enum":["mlb","ncaabase"]}},"additionalProperties":false}},{"name":"get_injuries","description":"Use for the injury report: every listed player's status, injury and expected return, as captured on the latest day (or the latest on or before date). Costs 2 credits.","credits":2,"category":"Basic lookup","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"team":{"type":"string"},"date":{"description":"YYYY-MM-DD (default: the latest).","type":"string"}},"additionalProperties":false}},{"name":"search_players","description":"Use to find a player's id by name (partial names work). Costs 1 credit.","credits":1,"category":"Static reference","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","description":"Full or partial name."},"limit":{"type":"integer","minimum":1,"maximum":50},"league":{"description":"League. Defaults to mlb. One of: mlb, ncaabase.","type":"string","enum":["mlb","ncaabase"]}},"required":["name"],"additionalProperties":false}},{"name":"get_player","description":"Use for a player's season-by-season batting (AVG, OBP, SLG, OPS, HR, K%, BB%, RE24, from every plate appearance) and pitching (ERA, WHIP, K/9, BB/9). Costs 5 credits.","credits":5,"category":"Stats + aggregation","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"player_id":{"type":"string","description":"ESPN athlete id, from search_players."},"league":{"description":"League. Defaults to mlb. One of: mlb, ncaabase.","type":"string","enum":["mlb","ncaabase"]}},"required":["player_id"],"additionalProperties":false}},{"name":"get_player_games","description":"Use for a player's game log: every game's batting line and pitching line, newest first, optionally one season. Costs 5 credits.","credits":5,"category":"Stats + aggregation","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"player_id":{"type":"string"},"season":{"description":"Season (a year, e.g. 2025; default: the latest).","type":["number","string"]},"season_type":{"type":"string","enum":["regular","postseason"]},"limit":{"type":"integer","minimum":1,"maximum":200},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991},"league":{"description":"League. Defaults to mlb. One of: mlb, ncaabase.","type":"string","enum":["mlb","ncaabase"]}},"required":["player_id"],"additionalProperties":false}},{"name":"get_leaders","description":"Use for a season's leaders among qualified players: batting avg, obp, slg, ops, hr, re24, bb_pct, k_pct (3.1 plate appearances per team game) or pitching era, whip, so, k_per_9, bb_per_9 (1 inning per team game). Costs 5 credits.","credits":5,"category":"Stats + aggregation","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"stat":{"type":"string","enum":["avg","obp","slg","ops","hr","re24","bb_pct","k_pct","era","whip","so","k_per_9","bb_per_9"]},"season":{"description":"Season (a year, e.g. 2025; default: the latest).","type":["number","string"]},"min_pa":{"description":"Override the plate-appearance minimum.","type":"integer","minimum":1,"maximum":9007199254740991},"min_ip":{"description":"Override the innings minimum.","type":"integer","minimum":1,"maximum":9007199254740991},"limit":{"type":"integer","minimum":1,"maximum":100},"league":{"description":"League. Defaults to mlb. One of: mlb, ncaabase.","type":"string","enum":["mlb","ncaabase"]}},"required":["stat"],"additionalProperties":false}},{"name":"get_team_stats","description":"Use for team offence and run prevention for a season: runs per game for and against, run differential, and batting and opponents' batting (AVG, OBP, SLG, OPS, K%, BB%, HR) from every plate appearance. Costs 5 credits.","credits":5,"category":"Stats + aggregation","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"season":{"description":"Season (a year, e.g. 2025; default: the latest).","type":["number","string"]},"team":{"type":"string"},"league":{"description":"League. Defaults to mlb. One of: mlb, ncaabase.","type":"string","enum":["mlb","ncaabase"]}},"additionalProperties":false}},{"name":"get_plate_appearances","description":"Use for plate-appearance play-by-play: a whole game in order, or a batter's, pitcher's or team's season, with the base-out state before, the result, the batted ball (trajectory and location), runs, the win probability after (2019 on) and our run value (RE24). Filter by result, inning or runners in scoring position. Costs 10 credits.","credits":10,"category":"Multi-table","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"game_id":{"type":"string"},"batter_id":{"type":"string"},"pitcher_id":{"type":"string"},"team":{"description":"Batting team (id or abbreviation).","type":"string"},"season":{"description":"Season (a year; default: the latest; ignored with game_id).","type":["number","string"]},"season_type":{"type":"string","enum":["regular","postseason"]},"result":{"description":"e.g. home-run, strikeout, walk, single, double, ground-out.","type":"string"},"inning":{"type":"integer","minimum":1,"maximum":25},"risp":{"description":"Runners in scoring position only.","type":"boolean"},"limit":{"description":"Max rows (default 200).","type":"integer","minimum":1,"maximum":1000},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991},"league":{"description":"League. Defaults to mlb. One of: mlb, ncaabase.","type":"string","enum":["mlb","ncaabase"]}},"additionalProperties":false}},{"name":"get_pitches","description":"Use for pitch-by-pitch data: every pitch of a game, or a pitcher's or batter's season, with the count, pitch type, velocity, location and result. Costs 10 credits.","credits":10,"category":"Multi-table","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"game_id":{"type":"string"},"pitcher_id":{"type":"string"},"batter_id":{"type":"string"},"season":{"description":"Season (a year; default: the latest; ignored with game_id).","type":["number","string"]},"pitch_type":{"description":"ESPN abbreviation, e.g. FF, SL, CH, CU, SI, FC.","type":"string"},"limit":{"description":"Max pitches (default 500).","type":"integer","minimum":1,"maximum":2000},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991}},"additionalProperties":false}},{"name":"get_pitch_mix","description":"Use for a pitcher's arsenal in a season: each pitch type's usage, average and top velocity, whiff rate per swing and ball rate. Costs 5 credits.","credits":5,"category":"Stats + aggregation","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"pitcher_id":{"type":"string","description":"ESPN athlete id."},"season":{"description":"Season (a year; default: the latest; ignored with game_id).","type":["number","string"]}},"required":["pitcher_id"],"additionalProperties":false}},{"name":"get_spray_chart","description":"Use for where a batter or team hits the ball: balls in play by trajectory (ground ball, line drive, fly ball, pop-up) and by field (left, center, right), with hit rates; include_balls adds each ball's location for drawing. Costs 10 credits.","credits":10,"category":"Multi-table","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"batter_id":{"type":"string"},"team":{"type":"string"},"season":{"description":"Season (a year; default: the latest; ignored with game_id).","type":["number","string"]},"include_balls":{"description":"Add each ball in play's x/y (up to 3,000).","type":"boolean"}},"additionalProperties":false}},{"name":"get_odds","description":"Use for betting lines: each sportsbook's moneyline, run line and total for a game (opening and closing from 2024; the final line before that), with implied probabilities and, for finished games, whether the favourite won and the total went over against the median close. Pass game_id for one game (5 credits) or date for a day's games (10 credits).","credits":5,"category":"Stats + aggregation","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"game_id":{"type":"string"},"date":{"description":"A day's games, YYYY-MM-DD (US Eastern).","type":"string"},"league":{"description":"League. Defaults to mlb. One of: mlb, ncaabase.","type":"string","enum":["mlb","ncaabase"]}},"additionalProperties":false}},{"name":"get_line_movement","description":"Use to see how a game's line moved before first pitch: our daily snapshot of each sportsbook's moneyline, run line and total. Costs 10 credits.","credits":10,"category":"Time-series","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"game_id":{"type":"string"},"provider":{"description":"One sportsbook, e.g. DraftKings.","type":"string"},"league":{"description":"League. Defaults to mlb. One of: mlb, ncaabase.","type":"string","enum":["mlb","ncaabase"]}},"required":["game_id"],"additionalProperties":false}},{"name":"get_ratings","description":"Use for our team power ratings (Elo from every final game in our data), ranked, as of the end of a season or today. Costs 2 credits.","credits":2,"category":"Basic lookup","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"season":{"type":["number","string"]},"league":{"description":"League. Defaults to mlb. One of: mlb, ncaabase.","type":"string","enum":["mlb","ncaabase"]}},"additionalProperties":false}}]}