Get Competition Matches
get_competition_matchesFixtures and results for a competition, Premier League, Championship, Primera División/La Liga, Serie A, Bundesliga, Ligue 1, Eredivisie, Primeira Liga, Brasileirão, Copa Libertadores, UEFA Champions League, European Championship, or the World Cup (see competition codes below). Filter by status (SCHEDULED, LIVE, IN_PLAY, PAUSED, FINISHED, POSTPONED, SUSPENDED, CANCELLED), date range, matchday, stage, or season year. "Next round" / "upcoming fixtures" questions: pass no status or status: "SCHEDULED", not a matchday number, unless the caller already knows which matchday number it is.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"competition": "PL"
},
"name": "get_competition_matches"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| stage | No | Stage (e.g., "GROUP_STAGE", "QUARTER_FINALS") | |
| season | No | Season start year (e.g., 2025) | |
| status | No | Match status filter (SCHEDULED | LIVE | IN_PLAY | PAUSED | FINISHED | POSTPONED | SUSPENDED | CANCELLED) | |
| date_to | No | YYYY-MM-DD | |
| matchday | No | Round number | |
| date_from | No | YYYY-MM-DD | |
| competition | Yes | Competition code (e.g., "PL" = Premier League, "PD" = La Liga, "CL" = Champions League) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes | Number of matches returned | |
| matches | Yes | ||
| competition | Yes | Competition code used in the query |