Skip to main content
Glama

Today's matches

get_today
Read-only

Retrieves 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

NameRequiredDescriptionDefault
tzNoIANA timezone for kickoff times, e.g. America/Mexico_City
dateNoDate as YYYY-MM-DD (default: today)
langNoLocale 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
flavorNoCommentary flair: off, subtle, full (default: full)
competitionNoThe 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

NameRequiredDescriptionDefault
dateYes
countYes
servedNoThe 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
sourceYes
horizonNoOff the World Cup, on an empty day read whole: no fixture that is on falls in this many provider days ahead
matchesYes
nextDayNoOff 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
partialNoPresent 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
degradedYes
truncatedYes
competitionNoThe 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
unknownTeamNoPresent (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
unsupportedNoPresent (true) when this is not available for this competition yet; an empty result then means "unsupported", not "none found"
inapplicableNoPresent (true) when this competition has no such thing at all (a league season with no knockout tie has no knockout tree)
marketSignalsNo
noCompetitionNoPresent (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>)
marketCompleteNoFalse when optional market enrichment did not check every relevant fixture
rosterEvidenceNoWith unknownTeam: the evidence it rests on, the competition's table and span (table) or the World Cup's bundled nations (bundle)
betweenEditionsNoPresent 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
rosterIncompleteNoPresent (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
responseTruncatedNo
responseTruncationNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changedv0.14.0
    • changedInput schema / properties / competition / description
      Previous value: -"The competition: an alias such as premier-league, 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"New value: +"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"
    • addedOutput schema / properties / horizon
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "Off the World Cup, on an empty day read whole: no fixture that is on falls in this many provider days ahead",
      +  "properties": {
      +    "days": {
      +      "exclusiveMinimum": 0,
      +      "type": "integer"
      +    }
      +  },
      +  "required": [
      +    "days"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / nextDay
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "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",
      +  "properties": {
      +    "count": {
      +      "exclusiveMinimum": 0,
      +      "type": "integer"
      +    },
      +    "date": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "date"
      +  ],
      +  "type": "object"
      +}
  2. Changed1 schema field changedv0.13.1
    • changedInput schema / properties / lang / description
      Previous value: -"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, fr (the market copy, a few notes and the disclaimer stay English; other locales fall back to en)"New value: +"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"
  3. Changed15 schema fields changedv0.12.0
    • addedInput schema / properties / competition
      Added value: +{
      +  "description": "The competition: an alias such as premier-league, 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",
      +  "type": "string"
      +}
    • changedInput schema / properties / lang / description
      Previous value: -"Locale for dates, provider attribution, and commentary: en, es, pt, fr (the summary scaffold stays English; other locales fall back to en)"New value: +"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, fr (the market copy, a few notes and the disclaimer stay English; other locales fall back to en)"
    • addedOutput schema / properties / betweenEditions
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "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",
      +  "properties": {
      +    "ended": {
      +      "type": "string"
      +    },
      +    "label": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "ended"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / competition
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": true,
      +      "properties": {
      +        "alias": {
      +          "type": "string"
      +        },
      +        "chosenBy": {
      +          "enum": [
      +            "flag",
      +            "env",
      +            "saved"
      +          ],
      +          "type": "string"
      +        },
      +        "experimental": {
      +          "const": true,
      +          "type": "boolean"
      +        },
      +        "name": {
      +          "type": "string"
      +        },
      +        "slug": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "slug",
      +        "name",
      +        "chosenBy"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "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"
      +}
    • addedOutput schema / properties / inapplicable
      Added value: +{
      +  "const": true,
      +  "description": "Present (true) when this competition has no such thing at all (a league season with no knockout tie has no knockout tree)",
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / matches / items / properties / events
      Added value: +{
      +  "items": {
      +    "additionalProperties": true,
      +    "properties": {
      +      "added": {
      +        "type": "number"
      +      },
      +      "minute": {
      +        "type": "number"
      +      },
      +      "player": {
      +        "type": "string"
      +      },
      +      "side": {
      +        "type": "string"
      +      },
      +      "teamCode": {
      +        "type": "string"
      +      },
      +      "type": {
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / matches / items / properties / home / properties / id
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / matches / items / properties / stageLabel
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / noCompetition
      Added value: +{
      +  "const": true,
      +  "description": "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>)",
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / partial
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "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",
      +  "properties": {
      +    "omitted": {
      +      "exclusiveMinimum": 0,
      +      "type": "integer"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedOutput schema / properties / rosterEvidence
      Added value: +{
      +  "description": "With unknownTeam: the evidence it rests on, the competition's table and span (table) or the World Cup's bundled nations (bundle)",
      +  "enum": [
      +    "table",
      +    "bundle"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / rosterIncomplete
      Added value: +{
      +  "const": true,
      +  "description": "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",
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / served
      Added value: +{
      +  "description": "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",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / unknownTeam
      Added value: +{
      +  "const": true,
      +  "description": "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",
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / unsupported
      Added value: +{
      +  "const": true,
      +  "description": "Present (true) when this is not available for this competition yet; an empty result then means \"unsupported\", not \"none found\"",
      +  "type": "boolean"
      +}
  4. Changed5 schema fields changedv0.10.0
    • addedOutput schema / properties / marketComplete
      Added value: +{
      +  "description": "False when optional market enrichment did not check every relevant fixture",
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / responseTruncated
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / responseTruncation
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / truncated
      Added value: +{
      +  "type": "boolean"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "date",
      -  "degraded",
      -  "source",
      -  "count",
      -  "matches"
      -]New value: +[
      +  "date",
      +  "degraded",
      +  "source",
      +  "count",
      +  "truncated",
      +  "matches"
      +]
  5. Addedv0.9.0
  6. Removedv0.8.15
  7. First observedv0.1.0

TDQS

A4.5/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations only declare readOnlyHint and openWorldHint; the description adds substantial behavioral context the agent could not otherwise know, including marketComplete=false meaning an incomplete read rather than no signal, betweenEditions semantics, and what 'partial' means for fixture coverage. It also explains that an empty day may mean an unreadable day rather than no fixture, and describes nextDay/horizon metadata.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The purpose and filtering rule are correctly front-loaded, but the middle is a dense, hard-to-parse run of nested edge-case clauses (the 'partial means...' passage requires re-reading). The content is largely worthwhile, but the packaging obscures it.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Covers defaults (date=today), competition resolution fallbacks including the noCompetition outcome, timezone and localization scope, and degradation semantics for incomplete reads. With an output schema present, no return-value explanation is needed, so nothing an agent needs to call this correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the inputs are already fully documented. The closing sentence adds modest cross-cutting meaning (tz affects kickoff rendering, lang affects localization plus empty/outage sentences, flavor sets commentary tone), but largely restates what the schema already says, so the baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Opens with a specific verb and resource ('All fixtures for a date (default: today)') plus the live-score overlay, which immediately distinguishes it from a single-match or in-play-only tool. The sibling routing sentence later reinforces that this is the whole-day card tool.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly states the selection rule: '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.' Each alternative is named with the condition that selects it, leaving nothing to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.