lastminutedeals-api

lastminutedeals-api

Real-time last-minute tour and activity booking across 18 suppliers in 15 countries via the OCTO open standard. Search available slots, create Stripe checkout sessions, and check booking status.

Category
Visit Server

README

Last Minute Deals HQ

Smithery

MCP server with real-time last-minute tour and activity inventory. 5,000+ live bookable slots across 18 suppliers in 15 countries, 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.

Install

Claude Desktop

npx -y @smithery/cli install @johnanleitner1/Last_Minute_Deals_HQ --client claude

Claude Code

npx -y @smithery/cli install @johnanleitner1/Last_Minute_Deals_HQ --client claude-code

Cursor

npx -y @smithery/cli install @johnanleitner1/Last_Minute_Deals_HQ --client cursor

Windsurf

npx -y @smithery/cli install @johnanleitner1/Last_Minute_Deals_HQ --client windsurf

Other 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/mcp

Tools

Tool Description
search_slots Search available tours and activities. Filter by city, category, hours_ahead window, and max_price. Returns live inventory sorted by urgency (soonest first).
book_slot 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_booking_status Check booking status by booking_id. Returns status, confirmation number, checkout URL (recoverable if lost), service details, and payment status.
get_supplier_info 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

17 active suppliers. Live inventory across Iceland, Italy, Mexico, Morocco, Portugal, Japan, Tanzania, Finland, Montenegro, Romania, Egypt, Turkey, United States, United Kingdom, and China.

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

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
/api/slots GET Search slots — city, category, hours_ahead, max_price
/api/book POST Create Stripe checkout for a slot
/api/book/direct POST Book with pre-funded wallet (autonomous agents)
/bookings/{id} GET Check booking status
/api/keys/register POST Get a free API key
/api/wallets/create POST Create a pre-funded agent wallet
/api/wallets/fund POST Get Stripe link to fund wallet
/health GET System health check
/metrics 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 18 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 confirmed

Status

  • Slots live: 5,000+
  • Suppliers: 17
  • Countries: 15
  • Refresh interval: Every 4 hours
  • Uptime: Hosted on Railway (24/7)
  • Payments: Stripe (authorization-then-capture — customer is never charged for a failed booking)

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured