Skip to main content
Glama

Booking status

advertiser.bookings.get
Read-only

A booking's status, placements, approval and payment state, and next_step.

Input Schema

NameRequiredDescriptionDefault
booking_idYesFrom advertiser.bookings.create or bookings.list.

Output Schema

NameRequiredDescriptionDefault
idNoThe booking_id.
errorNoPresent instead of the other fields when the call failed.
objectNoAlways "booking".
statusNoOne of: awaiting_approval, in_review, awaiting_payment, payment_expired, scheduled, live, finished, declined, cancelled.
paymentNoPayment state.
approvalNoThe account holder's approval and any staff check.
categoryNoThe advert's category.
currencyNoAlways "usd".
livemodeNoFalse in the sandbox.
quote_idNoThe quote it was booked from.
next_stepNoPlain-language instruction for what happens or what to do next.
total_usdNoTotal price in US dollars.
created_atNoWhen it was booked. ISO 8601, UTC.
placementsNoOne per venue, with its dates and state.
report_urlNoProof-of-display report (REST).
updated_atNoLast change. ISO 8601, UTC.
creative_idNoThe artwork shown.
campaign_nameNoThe campaign name.
status_reasonNoWhy it is declined or cancelled, if it is.
order_referenceNoWall Marketing's order reference once paid.
cancellation_requested_atNoWhen cancellation of a paid booking was requested. ISO 8601, UTC.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

C2.6/5.0
Behavior2/5

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

Annotations already declare readOnlyHint=true and openWorldHint=false, so the safety profile is covered. The description's remaining content (the returned fields) is redundant with the existing output schema and adds no behavioral context such as rate limits, side effects, or staleness of the approval/payment state.

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?

It is a single terse sentence fragment with no waste, but it leads with no verb or purpose statement and is arguably under-specified rather than well-structured. Efficiency is fine; front-loading of intent is weak.

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?

Because an output schema exists, return values need not be explained, and annotations cover read-only semantics; the single required parameter is documented. What is missing is the selection context relative to the many sibling booking tools (list, report, quote, update), which leaves the description minimally viable rather than complete.

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% and the single parameter is fully documented, including its provenance ('From advertiser.bookings.create or bookings.list'). The description adds nothing beyond the schema, so the baseline of 3 is appropriate.

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

Purpose3/5

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

The description enumerates the data returned ('status, placements, approval and payment state, and next_step') but never states the verb/action (retrieve/fetch), and it names no sibling. An agent can infer this fetches a booking's details, but it is a noun fragment rather than a specific verb+resource statement, and it does not distinguish itself from advertiser.bookings.list or advertiser.bookings.report.

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

Usage Guidelines2/5

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

There is no explicit guidance on when to call this versus advertiser.bookings.list (which also surfaces bookings) or advertiser.bookings.report. Usage is only implied by the name and the booking_id parameter; no exclusions or prerequisites (e.g., auth/role) are stated.

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.