Lastminutedeals Api MCP Server

Last Minute Deals HQ

MCP server with real-time last-minute tour and activity inventory. Live bookable slots across 32 suppliers in 47 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.

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

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

32 active suppliers. Live inventory across 47 countries including France, UK, Germany, Italy, Spain, Netherlands, Switzerland, Iceland, Egypt, Japan, Portugal, Turkey, Morocco, Tanzania, Finland, Montenegro, Romania, United States, United Kingdom, China, Mexico, Costa Rica, and more.

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

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 32 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: 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)