list_today_matches
List today's (UTC) fixtures — "what games are on today / right now?". Each fixture carries its status, live score, the live match clock (upstream minute text, verbatim e.g. "1h 25" / "2h 47" / "ht") when in-running, and a ready-to-read summary (live score & clock, or the kickoff time). Read clock...
This record as markdown: /tools/dev-infersports-infersports/list-today-matches.md
What list_today_matches does on Infersports
AI agents call list_today_matches to retrieve information from Infersports without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | integer | — | |
sport | object | — | |
league | object | — | |
status | object | — | |
timezone | object | — |
Parameters from the server's own tool schema.
Why list_today_matches is rated Low
This is a pure data retrieval operation that queries match fixtures and returns read-only information. There are no side effects, no data modification, no command execution, and no financial implications. It is a standard query/list operation appropriate for the Read category with low severity due to minimal potential for harm.
From the tool's definition Tool description explicitly states "Read-only" for the server. The tool lists today's fixtures with status, scores, and timing information. The function retrieves match data ("List today's fixtures") without any creation, modification, or deletion of data.
Attacks that exploit this kind of access
The rule that runs list_today_matches safely
PolicyLayer is an MCP gateway: it sits between your AI agents and Infersports, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For list_today_matches, this is the rule to start with:
list_today_matches is read-only, so it stays allowed. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect Infersports, apply this rule, and every list_today_matches call is checked against it from then on.
Questions about list_today_matches
List today's (UTC) fixtures — "what games are on today / right now?". Each fixture carries its status, live score, the live match clock (upstream minute text, verbatim e.g. "1h 25" / "2h 47" / "ht") when in-running, and a ready-to-read summary (live score & clock, or the kickoff time). Read clock for the real minute rather than estimating it from kickoff. clock is null pre-match. Args: sport: optional filter — "football" or "basketball". status: optional filter — "live", "scheduled" or "finished". league: optional league filter — a name (fuzzy-matched, e.g. "World Cup") or an external id ("lg_…"). limit: max fixtures to return (1–200, default 50). timezone: optional IANA timezone (e.g. "America/New_York", "Asia/Shanghai") to render each fixture's kickoff in its summary as local time; default UTC. It is categorised as a Read tool in the Infersports MCP Server, which means it retrieves data without modifying state.
list_today_matches accepts 5 parameters: limit, sport, league, status, timezone. The full parameter table on this page comes from the server's own tool schema.
Register the Infersports MCP server in PolicyLayer and add a rule for list_today_matches: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Infersports. Nothing to install.
list_today_matches is a Read tool with low risk. Read-only tools are generally safe to allow by default.
Yes. Add a rate_limit block to the list_today_matches rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for list_today_matches. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
list_today_matches is provided by the Infersports MCP server (https://api.infersports.dev/mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on Infersports, and thousands of servers like it.
This server
Across the catalogue