List games
list_gamesUse 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.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_games"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | To date, YYYY-MM-DD. | |
| date | No | One date, YYYY-MM-DD (a UTC day unless timezone is given). | |
| from | No | From date, YYYY-MM-DD. | |
| team | No | Club id, abbreviation or name. | |
| limit | No | Max matches (default 50). | |
| stage | No | league = league-table games (regular season, group stage, league phase); knockout = qualifying, knockout rounds and playoffs. | |
| league | No | League. Defaults to soccer. One of: soccer, mls, laliga, seriea, bundesliga, ligue1, ucl, championship, nwsl, ligamx, uel, uecl, eredivisie, primeira, scotland, brazil, argentina. | |
| offset | No | Page offset; use next_offset. | |
| season | No | Season by the year it starts: 2025 = 2025-26. MLS, the NWSL, Liga MX, Brazil and Argentina: the calendar year. Default: the latest. | |
| status | No | ||
| timezone | No | Read date, from and to as days in this IANA time zone (America/New_York, America/Mexico_City). Default UTC, where an evening kickoff in the Americas falls on the next day. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| count | Yes | ||
| games | Yes | ||
| next_offset | No |