Skip to main content
Glama

Prenota

book

Prenota a nome del cliente che ha effettuato l'accesso, senza codice. Conferma servizio, data e ora con la persona prima di chiamarlo.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
dateNoSolo per i servizi: data AAAA-MM-GG (da domani)
kindYes"service" per un servizio, "special_event" per una giornata speciale
slugYesSlug del servizio o della giornata speciale
timeYesOrario HH:MM tra quelli restituiti dalle availability
session_tokenYessession_token restituito da complete_login o complete_registration

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.5/5.0
Behavior3/5

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

Annotations already declare this is a non-read-only, non-idempotent, non-destructive write. The description adds real behavioral context beyond that: the booking is attributed to the logged-in session and needs no code, and the human must confirm details first. It does not, however, disclose what happens on duplicate calls (relevant given idempotentHint=false) or what the tool returns.

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

Conciseness5/5

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

Two short sentences with no waste; the identity/no-code constraint is front-loaded and the confirmation precondition follows. Every clause earns its place.

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

Completeness3/5

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

For a mutation tool with annotations covering the write profile and no output schema, the essentials are present. The gap is flow positioning: with request_booking and confirm_booking among siblings, the description never clarifies whether 'book' is immediate or provisional, which leaves an agent guessing about the multi-step booking sequence.

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 parameters are already fully documented (date only for services, time must come from availability, slug, session_token source). The description adds no parameter-level detail beyond what the schema carries, so the baseline of 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 description gives a specific verb and resource ('Prenota' / book a slot) and adds two distinguishing facts: it acts on behalf of the logged-in client and requires no code. It does not, however, differentiate itself from closely named siblings such as request_booking and confirm_booking, so an agent cannot fully disambiguate the booking flow from the text alone.

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?

It gives an operational precondition ('Conferma servizio, data e ora con la persona prima di chiamarlo'), which is useful procedural guidance, but says nothing about when to choose this tool over request_booking, confirm_booking, or the availability tools. Usage is only implied through the sibling set.

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