Today's matches
get_todayRetrieves all fixtures for a given date, defaulting to today, with live scores and minutes overlaid on any match in play. Use it to view a whole day's match card.
Instructions
All fixtures for a date (default: today), with live score and minute overlaid on any match in play. Optional prediction-market enrichment carries marketComplete; false means the read was incomplete, not that no signal exists. Off the World Cup, betweenEditions means the competition's edition ended before that date. partial means the provider sent records that could not be used: on the World Cup a fixture may then show from the bundled schedule without its live state (the text counts them, and names no provider when none shown was served), and where no bundled schedule was merged, an empty day means no fixture could be read for it, not that none is scheduled. Off the World Cup an empty day read whole may carry nextDay (the next local day with a fixture that is on, with count when known) or horizon (none in the next 14 days), when the schedule ahead was read whole. Use this for a whole day's card; for only in-play matches use get_live, for one team's match use get_next_fixture, for a single match's detail use get_match. Kickoffs render in tz; lang localizes the title, dates, status and stage words, the empty and outage sentences, attribution, and commentary (en/es/pt/fr); flavor sets commentary tone.
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": "get_today"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tz | No | IANA timezone for kickoff times, e.g. America/Mexico_City | |
| date | No | Date as YYYY-MM-DD (default: today) | |
| lang | No | Locale for dates, list titles, match status and stage words, a match timeline's kind words (Goal, Yellow card…), the empty and outage sentences, provider attribution, and commentary: en, es, pt or fr (no other value is supported). Without it, or when it is empty, the server's CLAUDINHO_LANG when that is exactly one of the four, else en. The market copy, a few notes and the disclaimer stay English | |
| flavor | No | Commentary flair: off, subtle, full (default: full) | |
| competition | No | The competition: an alias such as premier-league, its name (Premier League) or a short form (epl), or an ESPN slug such as eng.1 (list_competitions lists the aliases). Without it: the server's CLAUDINHO_COMPETITION, else the user's saved choice (claudinho follow); with none, the answer is noCompetition |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes | ||
| count | Yes | ||
| served | No | The shown fixtures whose record the provider's window held; a shown fixture not among them is the bundled schedule's row, its live state unconfirmed | |
| source | Yes | ||
| horizon | No | Off the World Cup, on an empty day read whole: no fixture that is on falls in this many provider days ahead | |
| matches | Yes | ||
| nextDay | No | Off the World Cup, on an empty day read whole: the next local day (YYYY-MM-DD, in tz) with a fixture that is on, and count, how many, when that whole day lies in the 14 days read | |
| partial | No | Present when the provider sent records that could not be used: what is returned is what was read, and may not be the whole answer (absence is not elimination). omitted is how many provider records were left out, when known; they may have lain outside what was asked for, so the count is a bound, not a loss | |
| degraded | Yes | ||
| truncated | Yes | ||
| competition | No | The competition this answer is for: its ESPN slug, its alias, its name, where the choice came from (flag: the competition argument; env: the server's CLAUDINHO_COMPETITION; saved: the user's saved choice, claudinho follow), and experimental for a slug the supported table does not hold; null with noCompetition when nothing is chosen | |
| unknownTeam | No | Present (true) when the roster the competition has holds no team by that name: the bundled nations on the World Cup; the table read whole and the next 14 days' fixtures elsewhere (a claim about that evidence, not the whole competition: a club out in a qualifying round is in no table). Never stated when the table or the span could not be read whole | |
| unsupported | No | Present (true) when this is not available for this competition yet; an empty result then means "unsupported", not "none found" | |
| inapplicable | No | Present (true) when this competition has no such thing at all (a league season with no knockout tie has no knockout tree) | |
| marketSignals | No | ||
| noCompetition | No | Present (true) when no competition is chosen (no competition argument, no server CLAUDINHO_COMPETITION, no saved choice): nothing was read, competition is null, and the text says what to do (pass competition, or the user runs claudinho follow <alias>) | |
| marketComplete | No | False when optional market enrichment did not check every relevant fixture | |
| rosterEvidence | No | With unknownTeam: the evidence it rests on, the competition's table and span (table) or the World Cup's bundled nations (bundle) | |
| betweenEditions | No | Present when the competition is between editions: the edition named by label ended on ended (the provider's calendar day, YYYY-MM-DD, the season end it states), and nothing in the read is scheduled or in play | |
| rosterIncomplete | No | Present (true) when the competition's roster could not be read whole and the name could not be resolved without it (no match, or only by a code or a partial name); not an outage: ask with the club's full name | |
| responseTruncated | No | ||
| responseTruncation | No |