Skip to main content
Glama

Prepare Reservation

prepare_reservation
Read-only

Prepare a one-tap booking handoff for the user's chosen campground/dates.

Returns a pre-filled deep link to the operator's reservation page plus the booking-window context (release date/time, operator rules, alert suggestion). Does NOT book on behalf: third-party booking is prohibited by Recreation.gov, ReserveCalifornia, ReserveAmerica, and every other supported public-land operator.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
end_dateYesCheck-out date (YYYY-MM-DD).
party_sizeNoOptional group size. Surfaced in the user-facing summary; most operators don't accept this in URL params, so it isn't embedded in the deep link.
start_dateYesCheck-in date (YYYY-MM-DD).
campground_idYesOutdoorithm CUID (e.g. ``RecreationDotGov:232447``).

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed5 schema fields changed
    • addedInput schema / additionalProperties
      Added value: +false
    • addedInput schema / properties / campground_id / description
      Added value: +"Outdoorithm CUID (e.g. ``RecreationDotGov:232447``)."
    • addedInput schema / properties / end_date / description
      Added value: +"Check-out date (YYYY-MM-DD)."
    • addedInput schema / properties / party_size / description
      Added value: +"Optional group size. Surfaced in the user-facing summary;\nmost operators don't accept this in URL params, so it isn't\nembedded in the deep link."
    • addedInput schema / properties / start_date / description
      Added value: +"Check-in date (YYYY-MM-DD)."
  2. First observed

TDQS

A4.3/5.0
Behavior5/5

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

Annotations already declare a read-only, non-destructive, non-open-world tool. The description adds meaningful behavioral context beyond that: it returns a deep link and booking-window details, and it explicitly does not book on behalf because third-party booking is prohibited by major operators.

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?

The description is tightly structured and front-loaded: purpose first, return contents second, and the key prohibition last. Every sentence earns its place and there is no redundant filler.

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?

Given full schema coverage, an output schema, and safety annotations, the description supplies everything an agent needs. It explains the handoff behavior, the return contents, and the non-booking boundary, completing the picture without over-explaining.

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 schema already documents all four parameters. The description refers generally to 'chosen campground/dates' but adds no syntax, format, or constraint details beyond what the schema provides, so the baseline of 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 states a specific verb and resource: 'Prepare a one-tap booking handoff' and returns a pre-filled deep link plus booking-window context. It clearly distinguishes itself from booking tools by stating it does not book on behalf, which separates it from any sibling that mutates reservations.

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 implies the tool is used once the user has already chosen a campground and dates. However, it does not explicitly say when to use this versus alternatives like check_availability, nor does it list prerequisites beyond the implied post-selection context.

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