Skip to main content
Glama

Book a poll's time

polls_book
Destructive

Book one of a poll's times in the calendar the person named to receive bookings: the time is checked again against every calendar, exactly the people the poll is for are invited by Microsoft or Google from that account's own address, the meeting written in the person's own time zone, and the poll closes. Its invitees' own hours hold it as they hold events_create, save for one who ticked that time, chosen on their own clock. An event holds its time as its provider's own free/busy shows it: on Google unless shown as available or declined - an invitation not yet answered or answered maybe included - and on Outlook only when shown busy or away, so an Outlook tentative answer leaves its time free; a cancelled event holds none.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
pollYesThe poll's id, as polls_create names it.
startYesThe time to book, as polls_results names it.
guestZonesNoA guest's own time zone, only as the person names it - never inferred from an address, a language or a provider.
unusualHoursAgreedNoTrue only once the person has agreed to send at the hours an answer named as unusual for a guest.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.6/5.0
Behavior4/5

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

Annotations already declare destructiveHint=true and openWorldHint=true, yet the description still adds real substance: the time is re-validated against every calendar, invitations are sent by Microsoft or Google from the host account's own address, the meeting is written in the host's time zone, and the poll is closed as a side effect. It also explains the provider-specific free/busy rules that determine whether a slot still 'holds' its time. The value is genuine, though the run-on phrasing blurs which details are guarantees versus conflict-detection heuristics.

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 action is front-loaded and there is little pure filler, but the description is a dense sequence of nested clauses ('exactly the people the poll is for are invited by Microsoft or Google from that account's own address') that is hard to parse on first read. Information density is high; readability and structure are poor.

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 no output schema, the description carries the return-value burden and does not say what comes back on success or what happens when the re-check shows the time no longer holds. It does, however, cover the major side effects, time-zone handling, and conflict semantics, which is substantial for a 4-parameter tool whose schema is fully documented.

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 'poll', 'start', 'guestZones' and 'unusualHoursAgreed' are already documented in the schema, including the explicit warning that a guest's zone is never inferred. The description adds nothing parameter-specific beyond the events_create analogy, so the baseline 3 applies.

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

Purpose4/5

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

The first sentence names a specific verb and resource: booking one of a poll's times into the calendar of the person who receives bookings, and it distinguishes the action from polls_create/polls_results/links_polls_close by describing the invite-and-close outcome. The archaic phrasing ('the person named to receive bookings') makes the actor harder to identify than it should be, but the core action is unambiguous.

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

Usage Guidelines3/5

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

Usage is only implied: the description references polls_results as the source of the 'start' value and compares invitee-hour handling to events_create, which hints at the post-poll-confirmation workflow. There is no explicit statement of when to call this versus polls_results (view times) or links_polls_close (close without booking), and no stated prerequisites such as the poll needing to be open.

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