Find matches
find_matchesFind football (soccer) matches and their current market odds by team, league, or both. Returns each match's kickoff time (UTC), status, home/draw/away probabilities, a match_id and its frontofgoal.com page. Use it for questions like "when do Arsenal play next?", "what Premier League games are on this weekend?" or "what's on today?". With no team or league it lists the most-traded matches. Use when "recent" for results from the last three days.
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": "find_matches"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| team | No | A team name as people say it, e.g. "Arsenal", "Man Utd", "Real Madrid", "PSG". | |
| when | No | Time window. today and tomorrow are UTC days; live is matches in play; recent is the last three days. | next_7_days |
| limit | No | Most matches to return (1 to 25). | |
| league | No | A league or cup: its id from list_leagues (e.g. "premier-league"), its name ("La Liga") or a common short name ("EPL", "UCL", "MLS"). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | Why the list is empty or cut short, and what to try. | |
| filter | No | ||
| matches | Yes | ||
| total_found | Yes | Matches found before the limit. | |
| other_teams_with_that_name | No |