lastminutedeals-api
This server provides real-time access to last-minute tour and activity inventory from 20+ suppliers across 15 countries, enabling you to search, book, and manage travel experiences.
Search Available Slots – Find live, bookable tours and activities filtered by city/country, category, time window (
hours_ahead, default 72h), max price (USD), and result limit. Inventory is refreshed every 4 hours across 28 cities.Book a Slot – Reserve tours or activities in two modes:
Approval Mode (default): Generates a Stripe Checkout URL for the customer to complete payment; booking is confirmed with the supplier after payment.
Autonomous Mode: Instantly completes the booking using a pre-funded agent wallet, returning a confirmation number directly — no human action required.
Supports group bookings via the
quantityparameter.
Check Booking Status – Retrieve the current status of a booking by
booking_id, including status (pending_payment,fulfilling,booked,failed,cancelled), confirmation number, service details, payment status, and a recoverable checkout URL if payment is still pending.Get Supplier Info – Explore the full supplier network to understand available destinations, experience types, booking platforms, and confirmation speeds before searching.
Manage Agent Wallets – Create and fund pre-funded wallets for autonomous booking mode.
Monitor System Health – Access endpoints for health checks and live metrics.
Searching requires no API key; booking requires a free API key (no credit card needed for basic access).
Provides payment processing for booking tours and activities, allowing creation of Stripe checkout sessions for customer payments and handling payment status tracking.
Serves as the production database backend for storing and querying live tour and activity inventory, enabling real-time search and booking operations.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
This Platform Is For Sale — $8,000 (Open to Offers)
47 live supplier contracts across 18 countries, MCP server on Smithery + Glama, Stripe payments, US LLC, domain, and infrastructure included.
Pre-revenue but production-ready. You're buying 6+ months of development time and 47 active supplier relationships.
View full details and make an offer | Email: bookings@lastminutedealshq.com
Last Minute Deals HQ
MCP server with real-time last-minute tour and activity inventory. Live bookable slots across 40 suppliers in 48 countries and 100+ cities, sourced live from production booking systems via the OCTO open standard. Inventory refreshed every 4 hours.
Search available slots and create Stripe checkout sessions — customers pay on our page, suppliers are confirmed automatically.
Related MCP server: Flights MCP
Install
Claude Desktop
npx -y @smithery/cli install @johnanleitner1/Last_Minute_Deals_HQ --client claudeClaude Code
npx -y @smithery/cli install @johnanleitner1/Last_Minute_Deals_HQ --client claude-codeCursor
npx -y @smithery/cli install @johnanleitner1/Last_Minute_Deals_HQ --client cursorWindsurf
npx -y @smithery/cli install @johnanleitner1/Last_Minute_Deals_HQ --client windsurfOther MCP Clients
npx -y @smithery/cli install @johnanleitner1/Last_Minute_Deals_HQ --client <client-name>Or connect directly to the remote MCP endpoint:
https://api.lastminutedealshq.com/mcpTools
Tool | Description |
| Search available tours and activities. Filter by city, category, |
| Book a slot for a customer. Approval mode (default) returns a Stripe checkout URL for the customer to pay. Autonomous mode charges a pre-funded wallet and returns a confirmation number directly. Supports quantity for group bookings. |
| Get a shareable booking page URL for a slot. The user clicks the link, sees full details, enters their own name/email/phone, and pays via Stripe. Use this when a human is browsing with an AI assistant. |
| Check booking status by |
| Returns the full supplier network — destinations, experience types, booking platform, and confirmation speed. Use before searching to understand what inventory is available. |
Example
"What tours are available in Rome this weekend under $50?"
search_slots(city="Rome", hours_ahead=72, max_price=50)[
{
"service_name": "E-Bike Tour of Ancient Rome & Appian Way",
"business_name": "Bicycle Roma",
"start_time": "2026-04-19T09:00:00+00:00",
"price": 42.00,
"currency": "EUR",
"location_city": "Rome",
"hours_until_start": 26.5,
"slot_id": "a1b2c3..."
},
{
"service_name": "Castelli Romani Wine & Food E-Bike Tour",
"business_name": "Bicycle Roma",
"start_time": "2026-04-19T13:00:00+00:00",
"price": 48.50,
"currency": "EUR",
"location_city": "Rome",
"hours_until_start": 30.5,
"slot_id": "d4e5f6..."
}
]"Book the e-bike tour for Jane Smith"
book_slot(
slot_id="a1b2c3...",
customer_name="Jane Smith",
customer_email="jane@example.com",
customer_phone="+15550001234"
){
"booking_id": "bk_a1b2c3_x9y8z7",
"status": "pending_payment",
"checkout_url": "https://checkout.stripe.com/c/pay/...",
"message": "Customer should complete payment at checkout_url"
}"Did she pay yet?"
get_booking_status(booking_id="bk_a1b2c3_x9y8z7"){
"status": "booked",
"confirmation_number": "BR-20260419-001",
"service_name": "E-Bike Tour of Ancient Rome & Appian Way",
"start_time": "2026-04-19T09:00:00+00:00",
"payment_status": "captured"
}Suppliers
40 active suppliers. Live inventory across 48 countries including France, UK, Germany, Italy, Spain, Netherlands, Switzerland, Iceland, Egypt, Japan, Portugal, Turkey, Brazil, Morocco, Tanzania, Finland, Montenegro, Romania, United States, United Kingdom, China, Mexico, Costa Rica, and more.
Supplier | Destinations | Experiences |
Arctic Adventures | Reykjavik, Husafell, Skaftafell, Iceland | Glacier hikes, ice caves, snowmobiling, aurora tours, whale watching, diving |
Bicycle Roma | Rome, Appia Antica, Castelli Romani | E-bike tours, food tours, guided city tours, bike rentals |
Boka Bliss | Kotor, Montenegro | Boat tours, sea caves, coastal experiences |
EgyExcursions | Cairo, Egypt | Pyramids, cultural tours, day trips |
Hillborn Experiences | Arusha, Serengeti, Zanzibar, Kilimanjaro | Private safaris, Kilimanjaro climbs, ultra-luxury wildlife tours |
Íshestar Riding Tours | Selfoss, Iceland | Horse riding, glacier rides, Viking tours |
Marvel Egypt Tours | Cairo, Luxor, Aswan | Pyramids, Nile cruises, temple tours |
O Turista Tours | Lisbon, Porto, Sintra, Fatima, Nazaré | Private tours, day trips, wine experiences |
Pure Morocco Experience | Marrakech, Sahara Desert | Desert tours, multi-day tours, cultural experiences |
Ramen Factory Kyoto | Kyoto, Japan | Cooking classes, ramen workshops |
REDRIB Experience | Helsinki, Finland | Speed boat tours, archipelago experiences |
TourTransfer Bucharest | Bucharest, Romania | City tours, Dracula castle, Peles castle |
Tours El Chiquiz | Puerto Vallarta, Mexico | Tequila tasting, hiking, nightlife tours, botanical gardens |
Trivanzo Holidays | Cairo, Luxor, Red Sea, Egypt | Nile cruises, cultural tours, desert tours |
TUTU VIEW Ltd | Shanghai, Xi'an, Beijing, Chengdu, Hangzhou | Multi-day tours, Silk Road, food tours, nature tours |
Vakare Travel Service | Antalya, Turkey | Boat tours, jeep safaris, cultural excursions |
All Washington View | Washington D.C. | City tours, sightseeing, monuments, panoramic views |
Zestro Bizlinks | Japan | Experiences |
Adi Tours - Nuba travel | Cairo, Egypt | Pyramids, cultural tours, Nile excursions, desert tours, day trips |
The Photo Experience | London, United Kingdom | Photography tours, photo walks, city photography experiences |
Sailing Windermere | Windermere, Lake District, United Kingdom | Sailing, lake cruises |
Perfect Day Tours | Luxor, Egypt | Temple tours, Valley of the Kings |
Nefertiti Tours | Cairo, Giza, Egypt | Pyramids, cultural tours |
Blue Dolphin Sailing | Guanacaste, Costa Rica | Sailing tours, sunset cruises, snorkeling |
EGYPT GATE | Cairo, Egypt | Tours and experiences |
Imperio tours | Rome, Italy | Fiat 500 tours, golf cart tours, food tours |
VIDABOA | Porto, Douro Valley, Portugal | Wine tours, private tours |
Gallo Tour | Rome, Italy | Golf cart tours |
Food Activity Japan | Osaka, Japan | Matcha making, food experiences |
European Voyages | Paris, London, Rome, Barcelona, Amsterdam, Berlin, Vienna, Prague, Budapest + 38 more | Walking tours, city tours, food tours, day trips, multi-day tours, river cruises, wine tours, cooking classes, transfers |
CruiserCar Palermo | Palermo, Sicily, Italy | Car tours, city tours, transfers |
Nile Navigators | Cairo, Luxor, Aswan, Egypt | Nile cruises, river tours, cultural experiences |
Fantastic Walks | United Kingdom | Walking tours |
Top Gear Tours | Cairo, Egypt | Tours and experiences |
Amazing Tours Agency | Brazil | Tours and experiences |
Anatolia Expedition | Istanbul, Turkey | Cultural tours, expeditions |
Turkey Tours Company | Istanbul, Turkey | Cultural tours, Cappadocia, Ephesus, day trips |
Eimverk Distillery | Reykjavik, Iceland | Distillery tours |
mondo guide srl | Rome, Italy | Guided tours, cultural experiences, day trips |
The Osaka&Tokyo | Osaka, Tokyo, Japan | Cultural experiences, city tours |
Categories
experiences · wellness · beauty · hospitality
API Key
Free. No credit card required. Needed for booking operations — search works without one.
curl -X POST https://api.lastminutedealshq.com/api/keys/register \
-H "Content-Type: application/json" \
-d '{"name": "MyAgent", "email": "agent@example.com"}'{"api_key": "lmd_..."}Pass the key when configuring the MCP server or as X-API-Key header for REST calls.
REST API
Base URL: https://api.lastminutedealshq.com
Endpoint | Method | Description |
| GET | Search slots — |
| POST | Create Stripe checkout for a slot |
| POST | Book with pre-funded wallet (autonomous agents) |
| GET | Check booking status |
| POST | Get a free API key |
| POST | Create a pre-funded agent wallet |
| POST | Get Stripe link to fund wallet |
| GET | System health check |
| GET | Live system metrics |
Booking Modes
Approval (default) — Returns a Stripe checkout URL. The customer visits the link, pays, and the booking is confirmed with the supplier automatically. Best for human-in-the-loop flows.
Autonomous — Requires a pre-funded wallet. The system debits the wallet instantly and confirms with the supplier. No redirect, no latency. Best for fully autonomous agents.
book_slot(
slot_id="...",
customer_name="Jane Smith",
customer_email="jane@example.com",
mode="autonomous",
wallet_id="wlt_..."
)How It Works
Every 4 hours:
fetch_octo_slots.py → Pull availability from 40 suppliers via OCTO API
aggregate_slots.py → Deduplicate, filter, sort by urgency
compute_pricing.py → Dynamic commission-based pricing
sync_to_supabase.py → Upsert to production database
MCP/REST requests:
Agent calls search_slots → Supabase query → Live results
Agent calls book_slot → Stripe checkout → OCTO booking → Supplier confirmedStatus
Slots live: 8,000+
Suppliers: 32
Countries: 47
Refresh interval: Every 4 hours
Uptime: Hosted on Railway (24/7)
Payments: Stripe (authorization-then-capture — customer is never charged for a failed booking)
Available Tools
4 toolsbook_slotAInspect
Book a last-minute slot for a customer. Two modes:
APPROVAL MODE (default — no wallet_id):
Creates a Stripe Checkout Session and returns a checkout_url.
You MUST share this URL with the customer immediately — do not summarise it,
do not wait, show it directly so they can complete payment.
The booking is confirmed with the supplier after payment succeeds.
The session expires in 24 hours.
AUTONOMOUS MODE (wallet_id + execution_mode='autonomous'):
The booking completes immediately using a pre-funded agent wallet.
Returns a confirmation_number directly — no checkout step, no human action needed.
Use this when your application manages payment on behalf of the customer.
Args:
slot_id: Slot ID from search_slots results.
customer_name: Full name of the person attending.
customer_email: Email address for booking confirmation.
customer_phone: Phone number including country code (e.g. +15550001234).
quantity: Number of people (default 1). Price is per-person × quantity.
wallet_id: Pre-funded agent wallet ID (format: wlt_...). Enables autonomous mode.
execution_mode: Set to 'autonomous' when providing a wallet_id.
Returns:
Approval mode: { success: true, checkout_url, booking_id, expires_at, action_required }
Autonomous mode: { success: true, confirmation_number, booking_id, status: 'booked' }
On error: { success: false, error }
Inputs: slot_id (required), customer_name (required), customer_email (required), customer_phone (required), +3 more.
get_booking_statusAInspect
Check the status of a booking.
Args:
booking_id: The booking_id returned by book_slot.
Returns:
Booking record with status, confirmation_number, service details, and checkout_url.
Status values:
pending_payment — awaiting customer checkout
fulfilling — payment received, confirming with supplier (up to 45s)
booked — confirmed by supplier; confirmation_number is set
failed — fulfillment failed; payment hold cancelled
cancelled — booking cancelled and refunded
Inputs: booking_id (required).
get_supplier_infoAInspect
Returns information about the supplier network and available inventory.
Use this to understand what destinations and experience types are available
before calling search_slots.
Inputs: no named parameters.
search_slotsAInspect
Search for last-minute available tours and activities.
Returns real production inventory from 19 suppliers (Adi Tours - Nuba travel, All Washington View,
Arctic Adventures, Bicycle Roma, Boka Bliss, EgyExcursions, Hillborn Experiences,
Íshestar Riding Tours, Marvel Egypt Tours, O Turista Tours, Pure Morocco Experience,
REDRIB Experience, Ramen Factory Kyoto, TourTransfer Bucharest, Tours El Chiquiz,
Trivanzo Holidays, TUTU VIEW Ltd, Vakare Travel Service, Zestro Bizlinks) sourced live via the OCTO open booking protocol.
Slots are sorted by urgency (soonest first).
Args:
city: City or country filter, partial match (e.g. "Reykjavik", "Rome", "Iceland").
Leave empty to search all locations.
category: Category filter. Use "experiences" for tours/activities.
Leave empty for all categories.
hours_ahead: Return slots starting within this many hours (default: 72).
max_price: Maximum price in USD. Set to 0 to return all prices.
limit: Max results to return (default 50). Results are sorted by urgency
so the most time-sensitive slots come first. Increase for broader
browsing (e.g. limit=500). Use city/category filters to narrow
results instead of raising the limit when possible.
Returns:
List of available slot dicts sorted by hours_until_start (soonest first).
Inputs: city, category, hours_ahead, max_price, +1 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool serves a clearly distinct stage of the booking workflow: supplier discovery, slot search, booking creation, and status lookup. There is no meaningful overlap or ambiguity between them.
All tool names follow a consistent verb_noun snake_case pattern: get_booking_status, get_supplier_info, search_slots, book_slot. The naming is predictable and makes each tool's purpose immediately obvious.
Four tools is well-scoped for a last-minute deals booking API: it covers the essential user journey without unnecessary duplication. The count fits comfortably within the ideal 3–15 range.
The core lifecycle is covered: search supplier info, search slots, book, and check booking status. However, there is no cancel or list-bookings operation, and the status enum includes cancelled without providing a way to trigger it, leaving a minor lifecycle gap.
Maintenance
Related MCP Connectors
Discover and book theatre, tours, attractions, and live experiences worldwide. No API key required.
Search, check availability and book tours and activities worldwide.
Find, price, and book tours, day trips, and activities worldwide, with live dates and prices.
Booking gateway for AI agents — discover events, movies & hotels, hand off to partner checkout.
Related MCP Servers
- AlicenseBqualityDmaintenanceThe first MCP server dedicated to families who travel with their kids. Find activities tested by families worldwide11MIT
- AlicenseAqualityDmaintenanceMCP server searching flights with granular filtering, sorting options, and purchase integration.415PythonGPL 3.0
- FlicenseAqualityCmaintenanceHotel booking MCP server — the first transaction-complete hotel booking integration for AI agents. Search 300K+ properties in 140+ countries, get live rates and room details, and generate secure checkout URLs. No payment in the AI conversation — guests complete booking at a hosted checkout page and receive a real hotel confirmation number. Set your own booking fee via Stripe Connect.830 npm3-
- AlicenseAqualityCmaintenanceDiscover and book theatre, shows, events, tours and experiences across 700+ cities worldwide on tickadoo® with real-time pricing and booking links.480 npm2MIT