lastminutedeals-api
Last Minute Deals HQ
直前ツアーおよびアクティビティの在庫をリアルタイムで提供するMCPサーバーです。OCTOオープン標準を介して、15カ国28都市、20社のサプライヤーから7,000件以上の予約可能な枠をライブで取得しています。在庫は4時間ごとに更新されます。
空き枠を検索し、Stripeチェックアウトセッションを作成できます。顧客がページ上で支払いを完了すると、サプライヤー側で自動的に予約が確定します。
インストール
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 windsurfその他のMCPクライアント
npx -y @smithery/cli install @johnanleitner1/Last_Minute_Deals_HQ --client <client-name>または、リモートMCPエンドポイントに直接接続します:
https://api.lastminutedealshq.com/mcpRelated MCP server: Flights MCP
ツール
ツール | 説明 |
| ツアーやアクティビティの空き枠を検索します。都市、カテゴリ、 |
| 顧客の予約枠を確保します。承認モード(デフォルト)では、顧客が支払うためのStripeチェックアウトURLを返します。自律モードでは、事前チャージ済みのウォレットから引き落とし、確認番号を直接返します。グループ予約の人数指定もサポートしています。 |
|
|
| サプライヤーネットワーク全体(目的地、体験の種類、予約プラットフォーム、確認速度)を返します。検索前に利用可能な在庫を確認するために使用してください。 |
例
「今週末、ローマで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さんのためにe-bikeツアーを予約して」
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"
}サプライヤー
20社のサプライヤーが稼働中。アイスランド、イタリア、メキシコ、モロッコ、ポルトガル、日本、タンザニア、フィンランド、モンテネグロ、ルーマニア、エジプト、トルコ、米国、英国、中国のライブ在庫を提供しています。
サプライヤー | 目的地 | 体験内容 |
Arctic Adventures | レイキャビク、フサフェル、スカフタフェットル、アイスランド | 氷河ハイキング、氷の洞窟、スノーモービル、オーロラツアー、ホエールウォッチング、ダイビング |
Bicycle Roma | ローマ、アッピア街道、カステッリ・ロマーニ | E-bikeツアー、フードツアー、ガイド付き市内ツアー、自転車レンタル |
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 | ワシントンD.C. | 市内ツアー、観光、記念碑、パノラマビュー |
Zestro Bizlinks | 日本 | 体験 |
Adi Tours - Nuba travel | カイロ、エジプト | ピラミッド、文化ツアー、ナイル川エクスカーション、砂漠ツアー、日帰り旅行 |
The Photo Experience | ロンドン、英国 | 写真ツアー、フォトウォーク、都市写真体験 |
カテゴリ
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
エンドポイント | メソッド | 説明 |
| GET | 空き枠の検索 — |
| POST | 枠のStripeチェックアウトを作成 |
| POST | 事前チャージ済みウォレットで予約(自律エージェント用) |
| GET | 予約状況の確認 |
| POST | 無料APIキーの取得 |
| POST | 事前チャージ済みエージェントウォレットの作成 |
| POST | ウォレットチャージ用のStripeリンク取得 |
| GET | システムヘルスチェック |
| 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 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ステータス
ライブ枠: 5,000件以上
サプライヤー: 17社
国: 15カ国
更新間隔: 4時間ごと
稼働率: Railwayでホスト(24時間365日)
支払い: Stripe(オーソリ・売上確定方式 — 予約失敗時に顧客に課金されることはありません)
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 }
| Name | Required | Description | Default |
|---|---|---|---|
| slot_id | Yes | ||
| customer_name | Yes | ||
| customer_email | Yes | ||
| customer_phone | Yes | ||
| quantity | No | ||
| wallet_id | No | ||
| execution_mode | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden and does an excellent job disclosing behavioral traits: it explains the two distinct modes, payment flow differences (Stripe Checkout vs. pre-funded wallet), session expiration (24 hours), and immediate action requirements (sharing URL directly). It doesn't cover rate limits or error handling specifics, but provides substantial operational context.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is well-structured with clear sectioning (two modes, args, returns), uses bullet points for readability, and every sentence earns its place by providing essential operational guidance. It's appropriately sized for a complex tool with multiple modes and avoids redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (7 parameters, two distinct modes, payment integration) and absence of both annotations and output schema, the description provides complete context: it explains both operational modes, documents all parameters, specifies return formats for both success cases and errors, and provides necessary implementation guidance. No significant gaps remain.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
With 0% schema description coverage, the description fully compensates by explaining all 7 parameters: it clarifies slot_id's source (search_slots results), provides format examples for customer_phone, explains quantity's effect on pricing, and crucially details the interaction between wallet_id and execution_mode that triggers autonomous mode. This adds significant meaning beyond the bare schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose with specific verbs ('Book a last-minute slot for a customer') and distinguishes it from siblings by focusing on booking functionality rather than searching (search_slots), checking status (get_booking_status), or retrieving supplier info (get_supplier_info). The two operational modes further clarify the specific actions involved.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides explicit guidance on when to use each mode: approval mode (default, no wallet_id) for customer-facing payment flows, and autonomous mode (wallet_id + execution_mode='autonomous') for automated payment scenarios. It clearly distinguishes between the two alternatives and specifies the conditions for each.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
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
| Name | Required | Description | Default |
|---|---|---|---|
| booking_id | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It effectively describes the tool as a read-only status check (implied by 'Check'), and details the possible status values with explanations, including time estimates (e.g., 'up to 45s' for fulfilling) and outcomes (e.g., 'payment hold cancelled' for failed). This adds valuable context beyond basic functionality.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is appropriately sized and front-loaded, starting with the core purpose. Each sentence earns its place: the first states the action, the second explains the parameter, the third describes the return, and the list details status values without redundancy. It is efficient and well-structured.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's low complexity (1 parameter, no output schema, no annotations), the description is complete. It covers the purpose, parameter semantics, return values, and status details, providing all necessary information for an agent to use the tool correctly without gaps.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The description adds significant meaning beyond the input schema, which has 0% description coverage. It explains that booking_id is 'returned by book_slot', clarifying its origin and purpose. This compensates fully for the schema's lack of documentation, providing essential context for the single parameter.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose with a specific verb ('Check') and resource ('status of a booking'), and distinguishes it from siblings like book_slot (which creates bookings) and search_slots (which finds available slots). It directly addresses what the tool does without being vague or tautological.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides clear context by referencing book_slot as the source for booking_id, implying this tool should be used after a booking is created. However, it does not explicitly state when not to use it or mention alternatives like get_supplier_info for supplier details, which could help avoid misuse.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
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.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It describes the tool as returning information, which implies a read-only operation, but doesn't explicitly state whether it's safe, whether it requires authentication, or any rate limits. The description adds some context about what information is returned (destinations and experience types) but lacks detailed behavioral traits. This is adequate but has clear gaps.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two sentences, front-loaded with the purpose followed by usage guidance. Every sentence earns its place by adding clear value, with zero waste or redundancy. It's appropriately sized for a simple tool.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's simplicity (0 parameters, no annotations, no output schema), the description is complete enough. It explains what the tool does and when to use it, which covers the essential context. However, it could benefit from more detail on return values or behavioral aspects, but for a read-only info tool, this is largely sufficient.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool has 0 parameters, and schema description coverage is 100% (though empty). The description doesn't need to add parameter semantics, so it naturally compensates by focusing on usage. Baseline for 0 parameters is 4, as the description provides value without parameter details.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: 'Returns information about the supplier network and available inventory.' It specifies both the resource ('supplier network and available inventory') and the action ('returns information'), though it doesn't explicitly distinguish from siblings beyond mentioning one alternative. The purpose is clear but sibling differentiation is only partial.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides explicit usage guidance: 'Use this to understand what destinations and experience types are available before calling search_slots.' It clearly states when to use this tool (before search_slots) and names a specific alternative (search_slots), which meets the criteria for a 5.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
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).
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | ||
| category | No | ||
| hours_ahead | No | ||
| max_price | No | ||
| limit | No |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden and does well by disclosing key behavioral traits: it returns 'real production inventory' from 19 specific suppliers, uses 'live' sourcing via OCTO protocol, sorts by urgency (soonest first), and explains result sorting logic. It doesn't mention rate limits or authentication requirements, but provides substantial operational context.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is efficiently structured with purpose statement, supplier list, sorting explanation, parameter documentation, and return format - all in appropriate detail. Every sentence adds value, and it's well-organized with clear sections for Args and Returns.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (5 parameters, no annotations, but has output schema), the description is remarkably complete. It covers purpose, behavioral context, detailed parameter semantics, and explains the return format. With an output schema present, it appropriately doesn't need to detail return value structure.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
With 0% schema description coverage, the description fully compensates by providing detailed semantics for all 5 parameters: explains city accepts partial matches and can be empty, specifies category should be 'experiences' for tours/activities, clarifies hours_ahead default and meaning, explains max_price=0 means all prices, and provides nuanced guidance on limit usage with sorting implications.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool searches for 'last-minute available tours and activities' with specific details about real inventory from 19 suppliers via OCTO protocol. It distinguishes from siblings like book_slot (booking) and get_booking_status (status checking) by focusing on search functionality.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides clear context for when to use this tool (searching for last-minute tours/activities) and includes practical guidance like 'Use city/category filters to narrow results instead of raising the limit when possible.' However, it doesn't explicitly state when NOT to use it or mention alternatives among sibling tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
4 tool updates
v0.1.1- Added
book_slot - Added
get_booking_status - Added
get_supplier_info - Added
search_slots
4 tool updates
v0.1.0- Removed
book_slot - Removed
get_booking_status - Removed
get_supplier_info - Removed
search_slots
4 tool updates
- First observed
book_slot - First observed
get_booking_status - First observed
get_supplier_info - First observed
search_slots
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
Booking gateway for AI agents — discover events, movies & hotels, hand off to partner checkout.
Discover, read and book verified real-world businesses through one endpoint.
Search and compare outdoor experiences. Public keyless API; booking and payment happen on Viator.
Search and book last-minute tours and activities in 28 cities from 21 suppliers.
Related MCP Servers
- AlicenseBqualityBmaintenanceThe first MCP server dedicated to families who travel with their kids. Find activities tested by families worldwide11MIT
- AlicenseAqualityFmaintenanceMCP server searching flights with granular filtering, sorting options, and purchase integration.415PythonGPL 3.0
- AlicenseAqualityCmaintenanceHotel 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.85 npm3-
- AlicenseAqualityCmaintenanceDiscover and book theatre, shows, events, tours and experiences across 700+ cities worldwide on tickadoo® with real-time pricing and booking links.42 npm1MIT