Spann Stays
Read-only sample stays, booking constraints, and staged reservation actions for review.
| Endpoint | https://mcp.spannhq.com/mcp (streamable-http) |
|---|---|
| Registry version | 0.2.1+canonical.1 |
| Now | 10 tools · grade C (74) · pin ts_e3feb9bdc4f94881f0e488152df39146 · protocol 2025-06-18 |
| First / last listed | 2026-11-14 01:31 UTC / 2026-11-14 01:31 UTC |
| Grade over time | 2026-11-14: C (74), 10 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: search_availability explain_booking_constraints prepare_reservation_action get_customer_property resolve_customer_route get_guest_observations discover_customer_stays prepare_discovered_stay get_spann_journey_status get_spann_booking_confirmation
search_availability | Search deterministic sample stay options from the Spann Stays fixture; no live inventory or property availability is queried. Set data_source=approved_customer_catalog for actual approved customer discovery (no live inventory); select using prepare_discovered_stay and a trusted desktop browser host. params: destination, property_id, stay*, guest_count*, language*, required_constraints, limit, budget, preferences, data_source |
explain_booking_constraints | Explain fixture-backed booking constraints for a sample property and rate; no property authority or live policy decision is provided. params: property_id*, room_rate_id*, language*, traveler_constraints |
prepare_reservation_action | Prepare a fixture-only reservation action for review; never holds a room, books, pays, sends, or contacts a property. Use sample traveler placeholders only. params: option_id*, room_rate_id*, traveler_packet*, special_requests, confirmation_language, desired_action_mode* |
get_customer_property | Read a published customer property record with public provenance and an official handoff route; unpublished records fail closed. params: property_id* |
resolve_customer_route | Resolve a published customer's official booking or inquiry URL from stay length; never checks inventory or sends an inquiry. params: property_id*, stay* |
get_guest_observations | Read moderated guest observations separately from property facts; no review collection or submission. params: property_id*, preference |
discover_customer_stays | Find eligible actual owner-approved customer property records by destination and traveler fit, without knowing a property name or ID. Read-only catalog discovery; no live availability or price. Returns fit evidence, limitations, official routes and expiring selection tokens. Coverage is limited to this approved catalog. Do not treat a conditional recommendation as a confirmed available/budget-matc params: destination*, stay*, guest_count*, budget, preferences, required_constraints, language, limit |
prepare_discovered_stay | Create a Spann journey for the selected actual customer record. Returns an opaque resume credential and a trusted-desktop browser task; does not execute a browser, fill guests, accept terms, book or pay. params: search_id*, property_id*, selection_token* |
get_spann_journey_status | Resume a Spann handoff by its opaque journey credential. Preparation reports are assistant-reported; booking and payment remain unconfirmed until independently reconciled with the provider. Confirmed states require an independently authorized property/provider receipt. Never send guest/card details. params: journey_id*, resume_token* |
get_spann_booking_confirmation | Read only booking/payment confirmation for a Spann reference using its separate long-lived confirmation token. Does not resume browser work or authorize confirmation. Synthetic receipts never become real booking/payment status. params: journey_id*, confirmation_token* |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.