Can an AI agent book a tour on Headout?

By Andrey Marey, Founder of AgentWeb · As of Oct 22, 2026

Short answer. Up to payment, through AgentWeb. As of Oct 22, 2026, the Headout map (version 0.1.0) gives your agent 15 actions. It can find experiences, read variants, the availability calendar, reviews and meeting points, check live inventory for a slot, compute the exact price breakdown and create the payment session for checkout. Completing the payment is not mapped yet.

Map: Headout (headout.com) · version 0.1.0 · 15 actions · Uses the person's own signed-in account

What your agent can do on Headout

Action	What it does
`create_payment_session`	Creates the payment session for a selected booking.

What your agent can read first

Action	What it returns
`get_checkout_page_info`	Fetch checkout page info for a selected tour booking Returns checkoutPageInfoItems with cancellationPolicy, ticketValidity, paxSelectionInstructions.
`search`	Search/autocomplete across the Headout catalog.
`get_tour_group_variants`	Fetch bookable variants for a tour group Returns tourGroupVariants keyed by tour-group id, each with variants[] (id, name, productId, variantInfo, language.
`get_tour_group_calendar`	Fetch the availability + pricing calendar for a tour group Returns a JSON "dates" map keyed by date (yyyy-MM-DD), each with primaryPax, listingPrice.
`get_payment_gateway_config`	Fetch the payment-gateway configuration for a given tour/experience Returns paymentGatewayCredentials (per-gateway publicKey, applePayMerchantID.
`check_live_inventory`	Check live inventory/availability for a specific tour slot Sends a tour group, tour id, local date/time, booking flow type, and a pax-to-count map; returns.
`get_booking_price_breakup`	Compute the price breakup for a booking selection Returns priceBreakup (per-variant originalPrice/finalPrice, pricePayableBreakup discounts/fees.
`get_city_categories`	Fetch the attraction category tree for a city Returns a JSON payload with "categories", each having id, name, rank, displayName, heading.
`get_top_collections`	Fetch the top collections (things to do) for a city Returns pageData.items[] with each collection's id, name/displayName, cityCode, urlSlug, hero/card image.
`get_nearby_cities`	Fetch nearby cities.
`get_tour_group_reviews`	Fetch customer reviews for a tour group Returns a JSON payload with an "items" array of reviews (id, tourId, bookingId, source, nonCustomerName, rating.
`get_tour_group_pinned_reviews`	Fetch pinned customer reviews for a tour group Returns result.items[] with per-review fields (tourId, bookingId, id, nonCustomerName, rating, content.
`get_tour_group_pois`	Fetch the points-of-interest (POIs) linked to a tour group Returns JSON with tourGroupId and a pois array where each poi carries id, name, type/subType.
`get_tour_group_service_points`	Fetch the service points (meeting/experience location details) for a tour group Returns a JSON payload with result.displayConfig (showSection, type e.g.

The person signs in once on Headout through AgentWeb's hosted login, started with agentweb_start_connection and confirmed with agentweb_poll_connection. Your agent never sees the password. Actions then run on that person's own account, and they can disconnect at any time.

Try it

curl -s https://mcp.agentweb.us/api/execute \
  -H "Authorization: Bearer $AGENTWEB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: headout-collections-1" \
  -d '{"domain":"headout.com","action":"get_top_collections","params":{"city":"lisbon"}}'

Parameter names shown are illustrative. Your agent gets the exact schema for every action from AgentWeb's list_actions tool.

What it does not cover yet

Completing payment is not mapped yet.
Cancelling a Headout booking is not mapped.

Frequently asked questions

Can the agent check a slot is really available?

Yes. check_live_inventory checks live availability for a specific slot, and get_booking_price_breakup returns the price for that selection.

What does it cost?

Each completed action costs $0.05, paid from prepaid blocks of $25, $50 or $100 that never expire. Failed actions are refunded.

Which AI tools can use it?

Any agent that speaks MCP or HTTP. Add https://mcp.agentweb.us/mcp as a remote MCP server in Claude, ChatGPT, Cursor, Codex or Grok, or call the REST endpoint directly.

Action list from AgentWeb's public sites API, snapshot Oct 22, 2026, 16:59 London time. Live coverage: mcp.agentweb.us/api/sites.

More: Sites AgentWeb can act on · All guides · Glossary · Install AgentWeb