Skip to main content
Glama

The Tennis Desk

A home match date, checked

match_date_check
Read-onlyIdempotent

Checks a proposed date and time for a home match before the captain posts it on the USTA NorCal league site. Pass the team, the match and the proposed date and start time, and the format and second-shift time if the captain has them. It says whether the form offers that time, which formats the form offers for the team's lines, and whether the team already plays that day. The Desk never acts on the USTA site, so the captain, or their own agent in their own session, presses Submit. Call it when a captain asks whether a date works, or before an agent fills the post-dates form.

Input Schema

NameRequiredDescriptionDefault
dateNoThe date the schedule shows for the match now, as 2026-10-24, to find it. Optional with opponent.
teamYesThe member's team: the Desk's team id, which is USTA NorCal's own team id, a link to its team page, or its name.
askedNoThe person's question word for word, never paraphrased. Leave it out rather than invent one.
formatNoThe match format, as the form names it: All 3, 2/1 or 1/2 for three lines, and All 5, 3/2, 2/3, 4/1 or 1/4 for five.
seasonNoSeason year. Defaults to the current season.
opponentNoThe other team in the match, as the schedule names it. With date, or alone.
proposedDateYesThe date the captain wants to post, as 2026-10-24.
proposedTimeYesThe start time the captain wants, as 6:30 PM.
secondShiftTimeNoThe second shift's start time, for a two-shift format.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.1/5.0
Behavior4/5

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

Annotations already declare readOnlyHint, idempotentHint and non-destructive, so the safety profile is covered. The description earns credit by adding what annotations cannot: that the check is a pre-post validation, that submission happens outside the Desk, and what three facts the answer contains. It doesn't discuss failure modes or what happens on an invalid date, which keeps it out of the top band.

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

Conciseness4/5

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

Five sentences, front-loaded with the check itself, then inputs, then outputs, then the operational boundary. Mostly earned, though 'the format and second-shift time if the captain has them' is wordier than needed and could collapse into a single clause.

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

Completeness4/5

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

With nine parameters, no output schema, and a read-only advisory role, the description does the important work: it lists the three result dimensions an agent must report back on. It leaves the exact response shape implicit and doesn't say how date/opponent together identify an existing match, but an agent can call it correctly from this text plus the schema.

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 every parameter, including the optional date/opponent match identifier and the verbatim 'asked' field, is already documented in structured form. The description only restates that team, match, date and time are passed, plus that format and second shift are optional when known. That is a marginal addition over the schema, 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?

The description names a specific verb and resource ('Checks a proposed date and time for a home match') and enumerates the three verdicts returned: whether the form offers the time, which formats are offered for the team's lines, and whether the team already plays that day. No sibling tool overlaps with this pre-flight validation job, and an agent can tell that immediately.

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

Usage Guidelines4/5

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

'Call it when a captain asks whether a date works, or before an agent fills the post-dates form' gives two concrete triggering situations. It also draws the boundary that the Desk never acts on the USTA site, so the tool is advisory only. It stops short of an explicit when-not or a named alternative, but nothing in the sibling list plays this role.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources