MLB API: Get player stats
Gets an MLB player's profile and regular-season hitting and pitching statistics for one season and for his career. Without a season it uses the current season, or the player's latest MLB season if he has no stats this year.
Unofficial. Not affiliated with or endorsed by MLB.
Inputs
Values from the run on Oct 27, 2026, shown under Output.
- Player, required
player Baseball player name, for example Shohei Ohtani.
Shohei Ohtani
- Season optional
season MLB season year, for example 2025. Defaults to the current season if the player has stats, otherwise the latest season.
2025
Whole number from 1871 to 2100.
Input as JSON
{ "player": "Shohei Ohtani", "season": 2025}Output
{ "age": 32, "bats": "Left", "name": "Shohei Ohtani", "team": "Los Angeles Dodgers", "season": 2025, "throws": "Right", "position": "Two-Way Player", "player_id": 660271, "player_link": "https://www.mlb.com/player/shohei-ohtani-660271" , "career_hitting": { "hits": 1194, "games": 1172, "at_bats": 4253, "home_runs": 310, "stolen_bases": 176, "runs_batted_in": 750, "batting_average": 0.281, "on_base_percentage": 0.375, "slugging_percentage": 0.574, "on_base_plus_slugging": 0.949 }, "season_hitting": { "hits": 172, "games": 158, "at_bats": 611, "home_runs": 55, "stolen_bases": 20, "runs_batted_in": 102, "batting_average": 0.282, "on_base_percentage": 0.392, "slugging_percentage": 0.622, "on_base_plus_slugging": 1.014 }, "career_pitching": { "wins": 47, "saves": 0, "walks": 208, "losses": 22, "strikeouts": 765, "innings_pitched": "614.1", "earned_run_average": 2.83, "walks_plus_hits_per_inning_pitched": 1.06 }, "season_pitching": { "wins": 1, "saves": 0, "walks": 9, "losses": 1, "strikeouts": 62, "innings_pitched": "47.0", "earned_run_average": 2.87, "walks_plus_hits_per_inning_pitched": 1.04 }, "headshot_image_link": "https://img.mlbstatic.com/mlb-photos/image/upload/v1/people/660271/headshot/67/current" }Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"mlb.com/get_player_stats","input":{"player":"Shohei Ohtani","season":2025}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "mlb.com/get_player_stats" , "input": { "player": "Shohei Ohtani", "season": 2025 }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "mlb.com/get_player_stats" , "input": { "player": "Shohei Ohtani", "season": 2025 } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run mlb.com/get_player_stats# with {"player":"Shohei Ohtani","season":2025}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "player" ], "properties": { "player": { "type": "string", "minLength": 1, "description": "Baseball player name, for example Shohei Ohtani." }, "season": { "type": "integer", "maximum": 2100, "minimum": 1871, "description": "MLB season year, for example 2025. Defaults to the current season if the player has stats, otherwise the latest season." } }}Output schema
{ "type": "object", "required": [ "name", "season", "player_id", "player_link", "headshot_image_link" ], "properties": { "age": { "type": [ "integer", "null" ] }, "bats": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "team": { "type": [ "string", "null" ] }, "season": { "type": "integer" }, "throws": { "type": [ "string", "null" ] }, "position": { "type": [ "string", "null" ] }, "player_id": { "type": "integer" }, "player_link": { "type": "string" }, "career_hitting": { "type": [ "object", "null" ] }, "season_hitting": { "type": [ "object", "null" ] }, "career_pitching": { "type": [ "object", "null" ] }, "season_pitching": { "type": [ "object", "null" ] }, "headshot_image_link": { "type": "string" } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
mlb.com/get_player_stats- Returns
- name, team, position, bats, throws, age, season and career hitting/pitching stats
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method mlb.com/get_player_stats with the inputs above.
Ask your agent
- What are Aaron Judge's batting numbers for the 2024 season?
- Show me Clayton Kershaw's career pitching stats and his ERA by year.
- Get Mookie Betts' position, bats, throws, and age along with his hitting stats this season.
- I want to compare Freddie Freeman's 2023 home runs and OPS against his career totals on mlb.com.
- Pull up Gerrit Cole's strikeouts and win-loss record for the 2019 season.
See more
All MLB methodsReturns MLB regular-season division standings for a season: records, win percentage, games back, streak, last 10 games and wild-card games back. Defaults to the current year.
mlb.com/get_standingsLists MLB games and scores for a date or up to seven days, optionally for one team. Start times are shown in the requested time zone.
mlb.com/get_scoresLooks up a Yahoo Sports player by name and returns the player's regular-season statistics for a season, alongside career totals. Each stat includes season and career values.
sports.yahoo.com/get_player_statsLooks up an NHL player by name, link or ID and returns the profile with regular-season stats for a season and career totals.
nhl.com/get_player_statsGets a named NFL player's season and career stats, with profile details. Active players are preferred when names match.
nfl.com/get_player_statsLooks up an ESPN player by name and returns season and career statistics. Use a league to tell apart players with the same name, and a season year or label to pick a past season.
espn.com/get_player_statsLooks up a Premier League player by name and returns the profile and either career totals or the stats for a chosen season. If names clash, a current Premier League player is preferred.
premierleague.com/get_player_statsLooks up an NBA player by name, including retired players, and returns the bio and regular-season per-game averages for the reported season and career.
nba.com/get_player