Servers Playground How we check Add a server Log in

StrikerAPI

Working · 2.0 s

io.github.noahowsh/strikerapiv1.1.6

Premier League, MLS and European football: lineups, shot maps, xG, tables and odds. REST and MCP.

Entertainment & Games

Source Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.strikerapi.com/mcp

x-api-key (required)

Your StrikerAPI API key. Get a free key (500 credits every month) at strikerapi.com/signup

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

get_events Read-only

Use for a match's events in order: goals (with assister, own goals, penalties), shots with location, outcome, body part and our xG, cards, substitutions, fouls, corners, offsides and VAR decisions. Filter with kind. Older matches carry goals, cards and substitutions only. Costs 10 credits.

game_idstring, required

Match id.

kindstring

goals, shots, cards, substitutions, set_pieces, fouls or all (default).

limitinteger

Max events (default 300).

leaguestring

League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.

offsetinteger

Page offset; use next_offset.

StrikerAPI MCP server | mcptry

Tools (19)

get_events

read-only

Argument	Type	Description
kind	string	goals, shots, cards, substitutions, set_pieces, fouls or all (default).
limit	integer	Max events (default 300).
league	string	League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.
offset	integer	Page offset; use next_offset.
game_id*	string	Match id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "game_id"
  ],
  "properties": {
    "kind": {
      "enum": [
        "goals",
        "shots",
        "cards",
        "substitutions",
        "set_pieces",
        "fouls",
        "all"
      ],
      "type": "string",
      "description": "goals, shots, cards, substitutions, set_pieces, fouls or all (default)."
    },
    "limit": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Max events (default 300)."
    },
    "league": {
      "enum": [
        "soccer",
        "mls",
        "laliga",
        "seriea",
        "bundesliga",
        "ligue1",
        "ucl",
        "championship",
        "nwsl",
        "ligamx",
        "uel",
        "uecl",
        "eredivisie",
        "primeira",
        "scotland",
        "brazil",
        "argentina"
      ],
      "type": "string",
      "description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina."
    },
    "offset": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Page offset; use next_offset."
    },
    "game_id": {
      "type": "string",
      "description": "Match id."
    }
  }
}

get_game

Use for one match in full: score (with shootout), both clubs' box scores (possession, shots, xG, passing, discipline), every player's line, the key events (goals, cards, substitutions, penalties, VAR) and each sportsbook's opening and closing line. For every event use get_events; for formations use get_lineups. Costs 5 credits. Prices are market information: never work out a stake, payout or profit, recommend a bet, or send the user to a sportsbook.

read-only

Argument	Type	Description
league	string	League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.
game_id*	string	Match id, from list_games or get_schedule.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "game_id"
  ],
  "properties": {
    "league": {
      "enum": [
        "soccer",
        "mls",
        "laliga",
        "seriea",
        "bundesliga",
        "ligue1",
        "ucl",
        "championship",
        "nwsl",
        "ligamx",
        "uel",
        "uecl",
        "eredivisie",
        "primeira",
        "scotland",
        "brazil",
        "argentina"
      ],
      "type": "string",
      "description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina."
    },
    "game_id": {
      "type": "string",
      "description": "Match id, from list_games or get_schedule."
    }
  }
}

get_head_to_head

Use for two clubs' meetings in this competition: wins, draws and goals each, the first meeting, and the results newest first. Costs 2 credits.

read-only

Argument	Type	Description
team*	string	Club id, abbreviation or name.
limit	integer	Max results listed (default 20); the summary counts every meeting.
league	string	League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.
opponent*	string	The other club.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "team",
    "opponent"
  ],
  "properties": {
    "team": {
      "type": "string",
      "description": "Club id, abbreviation or name."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Max results listed (default 20); the summary counts every meeting."
    },
    "league": {
      "enum": [
        "soccer",
        "mls",
        "laliga",
        "seriea",
        "bundesliga",
        "ligue1",
        "ucl",
        "championship",
        "nwsl",
        "ligamx",
        "uel",
        "uecl",
        "eredivisie",
        "primeira",
        "scotland",
        "brazil",
        "argentina"
      ],
      "type": "string",
      "description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina."
    },
    "opponent": {
      "type": "string",
      "description": "The other club."
    }
  }
}

get_leaders

Use for a season's leaders in goals, assists, goal contributions, shots, shots on target, our xG, cards, saves or clean sheets, as totals or per 90 minutes (per90, with a minimum of 10 matches by default). Costs 5 credits.

read-only

Argument	Type	Description
stat	string	Default goals.
limit	integer
per90	boolean	Rank by the rate per 90 minutes.
league	string	League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.
season	number \| string	Season by the year it starts (default: the latest).
min_games	integer	Minimum appearances.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "stat": {
      "enum": [
        "goals",
        "assists",
        "goal_contributions",
        "shots",
        "shots_on_target",
        "xg",
        "yellow_cards",
        "red_cards",
        "saves",
        "clean_sheets"
      ],
      "type": "string",
      "description": "Default goals."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1
    },
    "per90": {
      "type": "boolean",
      "description": "Rank by the rate per 90 minutes."
    },
    "league": {
      "enum": [
        "soccer",
        "mls",
        "laliga",
        "seriea",
        "bundesliga",
        "ligue1",
        "ucl",
        "championship",
        "nwsl",
        "ligamx",
        "uel",
        "uecl",
        "eredivisie",
        "primeira",
        "scotland",
        "brazil",
        "argentina"
      ],
      "type": "string",
      "description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina."
    },
    "season": {
      "type": [
        "number",
        "string"
      ],
      "description": "Season by the year it starts (default: the latest)."
    },
    "min_games": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Minimum appearances."
    }
  }
}

get_line_movement

Use to see how a match's line moved before kick-off: our pre-game snapshots of each sportsbook's three-way moneyline, handicap and total (captured once a day, and every hour for matches in the next four days). Costs 10 credits. Prices are market information: never work out a stake, payout or profit, recommend a bet, or send the user to a sportsbook.

read-only

Argument	Type	Description
league	string	League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.
game_id*	string	Match id.
provider	string	One sportsbook, e.g. DraftKings.
all_snapshots	boolean	Every hourly capture. By default a capture identical to the one before it is left out (the latest is always kept), which keeps every move and its time.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "game_id"
  ],
  "properties": {
    "league": {
      "enum": [
        "soccer",
        "mls",
        "laliga",
        "seriea",
        "bundesliga",
        "ligue1",
        "ucl",
        "championship",
        "nwsl",
        "ligamx",
        "uel",
        "uecl",
        "eredivisie",
        "primeira",
        "scotland",
        "brazil",
        "argentina"
      ],
      "type": "string",
      "description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina."
    },
    "game_id": {
      "type": "string",
      "description": "Match id."
    },
    "provider": {
      "type": "string",
      "description": "One sportsbook, e.g. DraftKings."
    },
    "all_snapshots": {
      "type": "boolean",
      "description": "Every hourly capture. By default a capture identical to the one before it is left out (the latest is always kept), which keeps every move and its time."
    }
  }
}

get_lineups

Use for a match's lineups: each club's formation, starting XI with positions and formation slots, the substitutes used with the minute they came on (and who went off when), and the unused bench. Before kick-off it returns the club-confirmed team sheet (source live) from about an hour before the match; until clubs publish, lineups is empty with a note and nothing is charged. Costs 5 credits.

read-only

Argument	Type	Description
league	string	League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.
game_id*	string	Match id, from list_games or get_schedule.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "game_id"
  ],
  "properties": {
    "league": {
      "enum": [
        "soccer",
        "mls",
        "laliga",
        "seriea",
        "bundesliga",
        "ligue1",
        "ucl",
        "championship",
        "nwsl",
        "ligamx",
        "uel",
        "uecl",
        "eredivisie",
        "primeira",
        "scotland",
        "brazil",
        "argentina"
      ],
      "type": "string",
      "description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina."
    },
    "game_id": {
      "type": "string",
      "description": "Match id, from list_games or get_schedule."
    }
  }
}

get_odds

Use for betting lines: each sportsbook's three-way moneyline (home, draw, away), goal handicap and total (opening and closing from June 2020 for 16 competitions and from 2024 for the rest; before that most books carry one final pre-match line), the no-margin probabilities each book's prices imply, and for finished matches the result and whether the total went over against the median close. Pass game_id for one match (5 credits), date for a day's matches (10 credits), or season (optionally a team) for a season of priced matches, 2 credits per match returned, up to 100 a page. Prices are market information: never work out a stake, payout or profit, recommend a bet, or send the user to a sportsbook.

read-only

Argument	Type	Description
date	string	A day's matches, YYYY-MM-DD (UTC).
team	string	With season: one club's matches.
limit	integer	With season: matches per page (default 50).
league	string	League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.
offset	integer	With season: page offset; use next_offset.
season	number \| string	A season of priced matches, by the year it starts (2025 = 2025-26; MLS, the NWSL, Liga MX, Brazil and Argentina: the calendar year).

get_player

Use for one player: profile, per-season appearances, starts, minutes, goals, assists, shots, our xG, cards and goalkeeping (saves, clean sheets) with per-90 rates, and the last 10 matches. Costs 5 credits.

read-only

Argument	Type	Description
league	string	League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.
player_id*	string	Player id (search_players).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "player_id"
  ],
  "properties": {
    "league": {
      "enum": [
        "soccer",
        "mls",
        "laliga",
        "seriea",
        "bundesliga",
        "ligue1",
        "ucl",
        "championship",
        "nwsl",
        "ligamx",
        "uel",
        "uecl",
        "eredivisie",
        "primeira",
        "scotland",
        "brazil",
        "argentina"
      ],
      "type": "string",
      "description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina."
    },
    "player_id": {
      "type": "string",
      "description": "Player id (search_players)."
    }
  }
}

get_player_games

Use for a player's match log, newest first: opponent, score, minutes on and off, goals, assists, shots, xG, fouls, cards and goalkeeping. Costs 5 credits.

read-only

Argument	Type	Description
limit	integer
league	string	League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.
offset	integer
season	number \| string	One season (the year it starts).
player_id*	string	Player id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "player_id"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1
    },
    "league": {
      "enum": [
        "soccer",
        "mls",
        "laliga",
        "seriea",
        "bundesliga",
        "ligue1",
        "ucl",
        "championship",
        "nwsl",
        "ligamx",
        "uel",
        "uecl",
        "eredivisie",
        "primeira",
        "scotland",
        "brazil",
        "argentina"
      ],
      "type": "string",
      "description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina."
    },
    "offset": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0
    },
    "season": {
      "type": [
        "number",
        "string"
      ],
      "description": "One season (the year it starts)."
    },
    "player_id": {
      "type": "string",
      "description": "Player id."
    }
  }
}

get_player_props

Use for player prop lines by sportsbook: the anytime goalscorer price, Yes in over_odds (and No in under_odds where a book posts it), with no line, from DraftKings, FanDuel, William Hill and Pinnacle as the archive holds them. Pass game_id for every player's props in one game (10 credits), or player_id with from_date (and to_date) for one player across games (10 credits per game returned, up to 100). Returns the closing line by default (the last before the game starts) or the opening line, with each book's over and under prices. Outside football the archive mostly holds one pre-game capture per line, so the opening and closing lines are usually the same; the opening line differs only where a second capture was taken (live capture from October 2026, and wherever else it is held). Set estimate_only to get the price without being charged. Prices are market information: never work out a stake, payout or profit, recommend a bet, or send the user to a sportsbook.

read-only

Argument	Type	Description
league	string	League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl.
market	string	One market: player_goal_scorer_anytime (anytime goalscorer (over = scores))
game_id	string	Game id: every player's props for that game.
to_date	string	With player_id: last date (default: no end), YYYY-MM-DD (the game's date).
bookmaker	string	Bookmaker key, e.g. draftkings, fanduel, pinnacle.

get_prop_history

Use to see how a player did against his prop line over time: for one market (anytime goalscorer: one row per match with the closing price and whether he scored), one row per game with the closing line (the median across books, or one book's), the opening line (the same as the close wherever only one capture was taken), the prices, what the player actually recorded from our box scores and the result against the line, plus the over rate. Costs 10 credits for up to 200 games. over_odds is the Yes price; result is over when he scored, under when he played and did not, and null when he was not in the squad or on the pitch (a void). Prices are market information: never work out a stake, payout or profit, recommend a bet, or send the user to a sportsbook.

read-only

Argument	Type	Description
limit	integer	Games to return, oldest first (default 50, max 200). next_from_date says where to continue.
league	string	League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl.
market*	string	The market: player_goal_scorer_anytime (anytime goalscorer (over = scores))
to_date	string	Last date, YYYY-MM-DD (the game's date).
bookmaker	string	One book's closing line instead of the median across books, e.g. draftkings.
from_date	string

get_ratings

Use for our club Elo ratings, strongest first, as of the latest match (or as of date). A 100-point gap is about a 64% expected score for the stronger side at a neutral venue. Costs 2 credits.

read-only

Argument	Type	Description
date	string	Ratings as of this day, YYYY-MM-DD (default: the latest).
limit	integer	Max clubs (default 50).
league	string	League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "date": {
      "type": "string",
      "description": "Ratings as of this day, YYYY-MM-DD (default: the latest)."
    },
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Max clubs (default 50)."
    },
    "league": {
      "enum": [
        "soccer",
        "mls",
        "laliga",
        "seriea",
        "bundesliga",
        "ligue1",
        "ucl",
        "championship",
        "nwsl",
        "ligamx",
        "uel",
        "uecl",
        "eredivisie",
        "primeira",
        "scotland",
        "brazil",
        "argentina"
      ],
      "type": "string",
      "description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina."
    }
  }
}

get_schedule

Use for upcoming fixtures (next 1-30 days, default 7) with the median three-way line across posted sportsbooks (home, draw, away moneylines, goal total, handicap) and its implied probabilities. For every book's line use get_odds. Costs 2 credits. Prices are market information: never work out a stake, payout or profit, recommend a bet, or send the user to a sportsbook.

read-only

Argument	Type	Description
days	integer	Days ahead (default 7).
team	string	Club id, abbreviation or name.
league	string	League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "days": {
      "type": "integer",
      "maximum": 30,
      "minimum": 1,
      "description": "Days ahead (default 7)."
    },
    "team": {
      "type": "string",
      "description": "Club id, abbreviation or name."
    },
    "league": {
      "enum": [
        "soccer",
        "mls",
        "laliga",
        "seriea",
        "bundesliga",
        "ligue1",
        "ucl",
        "championship",
        "nwsl",
        "ligamx",
        "uel",
        "uecl",
        "eredivisie",
        "primeira",
        "scotland",
        "brazil",
        "argentina"
      ],
      "type": "string",
      "description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina."
    }
  }
}

get_shot_map

Use for a shot map: a club's shots (or, with against, the shots it conceded), a player's, or one match's, for a season (default: the latest). Returns totals and zones (six-yard box, penalty area, outside the box, penalties) with goals, shots on target, xG and conversion, and every located shot with its x/y, end point, outcome and xG. Costs 10 credits.

read-only

Argument	Type	Description
team	string	Club id, abbreviation or name.
league	string	League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.
player	string	Player id (search_players).
season	number \| string	Season by the year it starts (default: the latest).
against	boolean	With team: the shots it conceded.
game_id	string	One match instead of a season.
include_shots	boolean	false = totals and zones only.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "team": {
      "type": "string",
      "description": "Club id, abbreviation or name."
    },
    "league": {
      "enum": [
        "soccer",
        "mls",
        "laliga",
        "seriea",
        "bundesliga",
        "ligue1",
        "ucl",
        "championship",
        "nwsl",
        "ligamx",
        "uel",
        "uecl",
        "eredivisie",
        "primeira",
        "scotland",
        "brazil",
        "argentina"
      ],
      "type": "string",
      "description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina."
    },
    "player": {
      "type": "string",
      "description": "Player id (search_players)."
    },
    "season": {
      "type": [
        "number",
        "string"
      ],
      "description": "Season by the year it starts (default: the latest)."
    },
    "against": {
      "type": "boolean",
      "description": "With team: the shots it conceded."
    },
    "game_id": {
      "type": "string",
      "description": "One match instead of a season."
    },
    "include_shots": {
      "type": "boolean",
      "description": "false = totals and zones only."
    }
  }
}

get_standings

Use for a season's league table: rank, played, won, drawn, lost, goals for and against, goal difference, points (official, with any deduction), qualification or relegation note, plus home and away records and recent form. Champions League: one table per group or the league phase. Costs 2 credits.

read-only

Argument	Type	Description
league	string	League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, uel, uecl, eredivisie, primeira, scotland, brazil.
season	number \| string	Season by the year it starts: 2025 = 2025-26. MLS, the NWSL, Liga MX, Brazil and Argentina: the calendar year. Default: the latest.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "league": {
      "enum": [
        "soccer",
        "mls",
        "laliga",
        "seriea",
        "bundesliga",
        "ligue1",
        "ucl",
        "championship",
        "nwsl",
        "uel",
        "uecl",
        "eredivisie",
        "primeira",
        "scotland",
        "brazil"
      ],
      "type": "string",
      "description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, uel, uecl, eredivisie, primeira, scotland, brazil."
    },
    "season": {
      "type": [
        "number",
        "string"
      ],
      "description": "Season by the year it starts: 2025 = 2025-26. MLS, the NWSL, Liga MX, Brazil and Argentina: the calendar year. Default: the latest."
    }
  }
}

get_team_stats

Use for clubs' per-match averages over a season, for and against: goals, our xG, shots, shots on target, possession, pass accuracy, corners, fouls, cards, tackles, clean sheets. Possession is missing for some leagues and seasons (for example the Eredivisie before 2020, the Scottish Premiership 2015 to 2023, the NWSL before 2025) and its average covers only matches that have it. Costs 5 credits.

read-only

Argument	Type	Description
team	string	One club.
league	string	League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.
season	number \| string	Season by the year it starts (default: the latest).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "team": {
      "type": "string",
      "description": "One club."
    },
    "league": {
      "enum": [
        "soccer",
        "mls",
        "laliga",
        "seriea",
        "bundesliga",
        "ligue1",
        "ucl",
        "championship",
        "nwsl",
        "ligamx",
        "uel",
        "uecl",
        "eredivisie",
        "primeira",
        "scotland",
        "brazil",
        "argentina"
      ],
      "type": "string",
      "description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina."
    },
    "season": {
      "type": [
        "number",
        "string"
      ],
      "description": "Season by the year it starts (default: the latest)."
    }
  }
}

list_games

Use to list fixtures and results by season, stage, date, date range or club, newest first. For upcoming fixtures with lines use get_schedule; for one match in full use get_game. Costs 2 credits.

read-only

Argument	Type	Description
to	string	To date, YYYY-MM-DD.
date	string	One date, YYYY-MM-DD (UTC).
from	string	From date, YYYY-MM-DD.
team	string	Club id, abbreviation or name.
limit	integer	Max matches (default 50).
stage	string	league = league-table games (regular season, group stage, league phase); knockout = qualifying, knockout rounds and playoffs.
league	string	League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.
offset	integer	Page offset; use next_offset.
season	number \| string

list_teams

Use to find club ids and abbreviations for a season (default: the latest). Every other tool takes a club as an id, abbreviation or name. Pass league for MLS (mls), La Liga (laliga), Serie A (seriea), the Bundesliga (bundesliga), Ligue 1 (ligue1), the Champions League (ucl), the EFL Championship (championship), the NWSL (nwsl), Liga MX (ligamx), the Europa League (uel), the Conference League (uecl), the Eredivisie (eredivisie), the Primeira Liga (primeira), the Scottish Premiership (scotland), Brazil's Serie A (brazil) or Argentina's Liga Profesional (argentina); default: the Premier League. Costs 1 credit.

read-only

Argument	Type	Description
league	string	League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.
season	number \| string	Season by the year it starts: 2025 = 2025-26. MLS, the NWSL, Liga MX, Brazil and Argentina: the calendar year. Default: the latest.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "league": {
      "enum": [
        "soccer",
        "mls",
        "laliga",
        "seriea",
        "bundesliga",
        "ligue1",
        "ucl",
        "championship",
        "nwsl",
        "ligamx",
        "uel",
        "uecl",
        "eredivisie",
        "primeira",
        "scotland",
        "brazil",
        "argentina"
      ],
      "type": "string",
      "description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina."
    },
    "season": {
      "type": [
        "number",
        "string"
      ],
      "description": "Season by the year it starts: 2025 = 2025-26. MLS, the NWSL, Liga MX, Brazil and Argentina: the calendar year. Default: the latest."
    }
  }
}

search_players

Use to find a player's id by name (accents optional), optionally within a club. Returns position, current club, last season and appearances. Costs 1 credit.

read-only

Argument	Type	Description
name*	string	Full or partial name, e.g. Saka.
team	string	Club id, abbreviation or name.
limit	integer
league	string	League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Full or partial name, e.g. Saka."
    },
    "team": {
      "type": "string",
      "description": "Club id, abbreviation or name."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1
    },
    "league": {
      "enum": [
        "soccer",
        "mls",
        "laliga",
        "seriea",
        "bundesliga",
        "ligue1",
        "ucl",
        "championship",
        "nwsl",
        "ligamx",
        "uel",
        "uecl",
        "eredivisie",
        "primeira",
        "scotland",
        "brazil",
        "argentina"
      ],
      "type": "string",
      "description": "League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina."
    }
  }
}