Last Minute Deals HQ

Smithery

MCP 服务器，提供实时的最后一分钟旅游和活动库存。通过 OCTO 开放标准从生产预订系统中实时获取，涵盖 15 个国家/地区 17 家供应商的 5,000 多个可预订时段。库存每 4 小时刷新一次。

搜索可用时段并创建 Stripe 结账会话——客户在我们的页面上付款，供应商会自动确认。

安装

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

其他 MCP 客户端

npx -y @smithery/cli install @johnanleitner1/Last_Minute_Deals_HQ --client <client-name>

或者直接连接到远程 MCP 端点：

https://api.lastminutedealshq.com/mcp

工具

工具	描述
`search_slots`	搜索可用的旅游和活动。按城市、类别、`hours_ahead` 时间窗口和 `max_price` 进行筛选。返回按紧急程度（最先开始的优先）排序的实时库存。
`book_slot`	为客户预订时段。审批模式（默认）返回一个 Stripe 结账 URL 供客户付款。自主模式扣除预充值钱包余额并直接返回确认号。支持团体预订的数量设置。
`get_booking_status`	通过 `booking_id` 检查预订状态。返回状态、确认号、结账 URL（如果丢失可恢复）、服务详情和付款状态。
`get_supplier_info`	返回完整的供应商网络——目的地、体验类型、预订平台和确认速度。在搜索前使用以了解有哪些库存可用。

示例

“本周末罗马有哪些 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..."
  }
]

“为 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"
}

“她付款了吗？”

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"
}

供应商

17 家活跃供应商。实时库存覆盖冰岛、意大利、墨西哥、摩洛哥、葡萄牙、日本、坦桑尼亚、芬兰、黑山、罗马尼亚、埃及、土耳其、美国、英国和中国。

供应商	目的地	体验
Arctic Adventures	雷克雅未克、胡萨维克、斯卡夫塔山、冰岛	冰川徒步、冰洞、雪地摩托、极光之旅、观鲸、潜水
Bicycle Roma	罗马、阿皮亚古道、罗马城堡区	电动自行车之旅、美食之旅、城市导览、自行车租赁
Boka Bliss	科托尔、黑山	游船之旅、海蚀洞、沿海体验
EgyExcursions	开罗、埃及	金字塔、文化之旅、一日游
Hillborn Experiences	阿鲁沙、塞伦盖蒂、桑给巴尔、乞力马扎罗	私人游猎、乞力马扎罗攀登、超豪华野生动物之旅
Íshestar Riding Tours	塞尔福斯、冰岛	骑马、冰川骑行、维京之旅
Marvel Egypt Tours	开罗、卢克索、阿斯旺	金字塔、尼罗河游船、寺庙之旅
O Turista Tours	里斯本、波尔图、辛特拉、法蒂玛、纳扎雷	私人旅游、一日游、葡萄酒体验
Pure Morocco Experience	马拉喀什、撒哈拉沙漠	沙漠之旅、多日游、文化体验
Ramen Factory Kyoto	京都、日本	烹饪课程、拉面工作坊
REDRIB Experience	赫尔辛基、芬兰	快艇之旅、群岛体验
TourTransfer Bucharest	布加勒斯特、罗马尼亚	城市之旅、德古拉城堡、佩莱斯城堡
Tours El Chiquiz	巴亚尔塔港、墨西哥	龙舌兰酒品鉴、徒步、夜生活之旅、植物园
Trivanzo Holidays	开罗、卢克索、红海、埃及	尼罗河游船、文化之旅、沙漠之旅
TUTU VIEW Ltd	上海、西安、北京、成都、杭州	多日游、丝绸之路、美食之旅、自然之旅
Vakare Travel Service	安塔利亚、土耳其	游船之旅、吉普车游猎、文化考察
All Washington View	华盛顿特区	城市之旅、观光、纪念碑、全景游览

类别

experiences · wellness · beauty · hospitality

API 密钥

免费。无需信用卡。预订操作需要密钥——搜索功能无需密钥即可使用。

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_..."}

在配置 MCP 服务器时传入密钥，或在 REST 调用中作为 X-API-Key 请求头传入。

REST API

基础 URL: https://api.lastminutedealshq.com

端点	方法	描述
`/api/slots`	GET	搜索时段 — `city`, `category`, `hours_ahead`, `max_price`
`/api/book`	POST	为时段创建 Stripe 结账会话
`/api/book/direct`	POST	使用预充值钱包预订（自主代理）
`/bookings/{id}`	GET	检查预订状态
`/api/keys/register`	POST	获取免费 API 密钥
`/api/wallets/create`	POST	创建预充值代理钱包
`/api/wallets/fund`	POST	获取 Stripe 链接以充值钱包
`/health`	GET	系统健康检查
`/metrics`	GET	实时系统指标

预订模式

审批（默认） — 返回一个 Stripe 结账 URL。客户访问该链接并付款，预订会自动与供应商确认。最适合有人参与的流程。

自主 — 需要预充值钱包。系统会立即扣除钱包余额并与供应商确认。无需重定向，无延迟。最适合完全自主的代理。

book_slot(
  slot_id="...",
  customer_name="Jane Smith",
  customer_email="jane@example.com",
  mode="autonomous",
  wallet_id="wlt_..."
)

工作原理

Every 4 hours:
  fetch_octo_slots.py   →  Pull availability from 17 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

状态

实时时段： 5,000+
供应商： 17
国家/地区： 15
刷新间隔： 每 4 小时
正常运行时间： 托管在 Railway 上 (24/7)
支付： Stripe（先授权后扣款 — 客户绝不会因预订失败而被扣费）

lastminutedeals-api