get_competition_matches
ActiveTool of Football Data
declared in 0.1.0
List matches in a competition. Filter by status (SCHEDULED, LIVE, IN_PLAY, PAUSED, FINISHED, POSTPONED, SUSPENDED, CANCELLED), date range, matchday, stage, or season year.
Parameters schema
{
"type": "object",
"examples": [
{
"competition": "PL"
},
{
"season": 2024,
"status": "FINISHED",
"competition": "CL"
}
],
"required": [
"competition"
],
"properties": {
"stage": {
"type": "string",
"description": "Stage (e.g., \"GROUP_STAGE\", \"QUARTER_FINALS\")"
},
"season": {
"type": "number",
"description": "Season start year (e.g., 2025)"
},
"status": {
"type": "string",
"description": "Match status filter (SCHEDULED | LIVE | IN_PLAY | PAUSED | FINISHED | POSTPONED | SUSPENDED | CANCELLED)"
},
"date_to": {
"type": "string",
"description": "YYYY-MM-DD"
},
"matchday": {
"type": "number",
"description": "Round number"
},
"date_from": {
"type": "string",
"description": "YYYY-MM-DD"
},
"competition": {
"type": "string",
"description": "Competition code (e.g., \"PL\" = Premier League, \"PD\" = La Liga, \"CL\" = Champions League)"
}
}
}No endpoints wrapped at confidence ≥ 0.70.
Parent server
Football Data
https://github.com/pipeworx-io/mcp-football-data
1/7 registries