mcp
Book hotels over MCP. Pay over x402. 3M+ properties in 200+ countries, USDC on Base.
我该使用它吗
质量与安全性
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高,可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中:
{
"mcpServers": {
"mcp": {
"url": "https://trip1.com/api/mcp"
}
}
}远程端点
https://trip1.com/api/mcpstreamable-http它能做什么
工具清单
工具(6)
🟢search_hotels(destination, check_in, check_out, sort_by, sort_order, ...)
Search for available hotels by destination and dates. Returns a list of matching hotels with pricing, images, and booking links. Occupancy is fixed at 2 adults in one room and cannot be set. If the user asked for a different party size, tell them these prices are for 2 adults rather than presenting them as a quote for their group. Always include the hotel name, booking link, and image for each hotel in your response.
输入模式
{
"type": "object",
"properties": {
"destination": {
"type": "string",
"description": "Destination name (e.g., 'London', 'Paris, France', 'Vilnius')"
},
"check_in": {
"type": "string",
"description": "Check-in date in YYYY-MM-DD format. Must be today or later in the destination's own timezone. Do not assume the current year — the server instructions state today's date; a past date is rejected, and the rejection tells you the destination's today."
},
"check_out": {
"type": "string",
"description": "Check-out date in YYYY-MM-DD format. Must be after check_in."
},
"sort_by": {
"type": "string",
"description": "Sort results by: price, rating, distance, or relevance (default)",
"enum": [
"relevance",
"price",
"rating",
"distance"
]
},
"sort_order": {
"type": "string",
"description": "Sort order: asc (default) or desc",
"enum": [
"asc",
"desc"
]
},
"context": {
"type": "string",
"maxLength": 200,
"description": "Why are you calling this tool? Describe the user's underlying goal in one short sentence — not the tool name. Never include names, emails, phones, or prices. Always pass this. Used for analytics only; never shown to the user."
}
},
"required": [
"destination",
"check_in",
"check_out"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"total_results": {
"type": "integer"
},
"hotels": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Hotel id to pass to get_hotel_details"
},
"name": {
"type": "string"
},
"star_rating": {
"type": "integer"
},
"image_url": {
"type": [
"string",
"null"
]
},
"image_urls": {
"type": "array",
"items": {
"type": "string"
},
"description": "Up to 5 photos, primary first; for the results view, not sent to the model"
},
"price": {
"type": "number",
"description": "Cheapest total stay price for 2 adults"
},
"currency": {
"type": "string"
},
"booking_link": {
"type": "string"
}
},
"required": [
"id",
"name",
"star_rating",
"image_url",
"image_urls",
"price",
"currency",
"booking_link"
]
}
}
},
"required": [
"total_results",
"hotels"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_hotel_details(id, context)
Get rooms and rates for a hotel. Pass the hotel id from search_hotels results. Returns rate IDs needed for purchase_hotel. Each rate states its refundability and, when refundable, the cancellation deadline — quote these rather than inferring refund terms. When prices_changed is true, the price search_hotels quoted for this hotel is no longer the one on offer — tell the user prices changed rather than presenting these rates as the same quote. When the user picks a rate, call start_checkout with its id next -- it opens the booking form, so do not ask for guest details in chat.
输入模式
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The hotel id from search_hotels results"
},
"context": {
"type": "string",
"maxLength": 200,
"description": "Why are you calling this tool? Describe the user's underlying goal in one short sentence — not the tool name. Never include names, emails, phones, or prices. Always pass this. Used for analytics only; never shown to the user."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"name": {
"type": "string"
},
"star_rating": {
"type": "integer"
},
"address": {
"type": [
"string",
"null"
]
},
"check_in": {
"type": "string",
"description": "Earliest check-in time, HH:MM"
},
"check_out": {
"type": "string",
"description": "Latest check-out time, HH:MM"
},
"stay": {
"type": "object",
"description": "The dates and party these rates are for",
"properties": {
"check_in": {
"type": "string",
"description": "YYYY-MM-DD"
},
"check_out": {
"type": "string",
"description": "YYYY-MM-DD"
},
"adults": {
"type": "integer"
}
},
"required": [
"check_in",
"check_out",
"adults"
]
},
"image_urls": {
"type": "array",
"items": {
"type": "string"
},
"description": "Up to 5 hotel photos, primary first; for the rooms view, not sent to the model"
},
"rooms": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"image_urls": {
"type": "array",
"items": {
"type": "string"
}
},
"rates": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Rate id to pass to purchase_hotel"
},
"board_type": {
"type": "string"
},
"price": {
"type": "number"
},
"currency": {
"type": "string"
},
"refundability": {
"type": "string",
"enum": [
"fully_refundable",
"partially_refundable",
"non_refundable"
]
},
"cancellation_deadline": {
"type": [
"string",
"null"
],
"description": "Free cancellation until this time for fully_refundable rates, partial refund until it for partially_refundable; null for non_refundable"
}
},
"required": [
"id",
"board_type",
"price",
"currency",
"refundability",
"cancellation_deadline"
]
}
}
},
"required": [
"name",
"image_urls",
"rates"
]
}
},
"next_step": {
"type": "string",
"description": "What to call once the user picks a rate"
},
"prices_changed": {
"type": [
"boolean",
"null"
],
"description": "true when these rates come from a different provider than the search_hotels quote; null when the search recorded no winner"
}
},
"required": [
"name",
"star_rating",
"address",
"check_in",
"check_out",
"stay",
"image_urls",
"rooms",
"next_step",
"prices_changed"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢start_checkout(rate_id, first_name, last_name, email, phone, ...)
Open the booking form for a rate the user picked from get_hotel_details. Shows the stay and the price, and lets the user enter the guest details and choose how to pay. On the first call, pass the user's own details you already know -- from this conversation or your memory of them -- so the form opens prefilled, and only those: never invent or guess any; the form asks for the rest and the user reviews every field before booking. If the user has not stated a title, pass title_suggestion instead: your best guess from their first name, which the form labels as a suggestion. If the user submits the form, it books the room itself (purchase_hotel) and tells you the booking reference: do not call purchase_hotel again for it. Call this again with more details to refill the form.
输入模式
{
"type": "object",
"properties": {
"rate_id": {
"type": "string",
"description": "Rate id from get_hotel_details"
},
"first_name": {
"type": "string",
"description": "Guest's first name, if known"
},
"last_name": {
"type": "string",
"description": "Guest's last name, if known"
},
"email": {
"type": "string",
"description": "Guest's email, if known"
},
"phone": {
"type": "string",
"description": "Guest's phone with country code, if known"
},
"title": {
"type": "string",
"description": "MR, MRS, MS or MISS, only if the user has stated it",
"enum": [
"MR",
"MRS",
"MS",
"MISS"
]
},
"title_suggestion": {
"type": "string",
"enum": [
"MR",
"MRS",
"MS",
"MISS"
],
"description": "When the user has not stated a title: your best guess from their first name. The form preselects it, labelled as a suggestion from their name, and the user can change it."
},
"nationality": {
"type": "string",
"description": "Guest's nationality as ISO 3166-1 alpha-2, if known"
},
"payment_service": {
"type": "string",
"description": "Payment method the user already chose, if any",
"enum": [
"coingate",
"x402"
]
},
"context": {
"type": "string",
"maxLength": 200,
"description": "Why are you calling this tool? Describe the user's underlying goal in one short sentence — not the tool name. Never include names, emails, phones, or prices. Always pass this. Used for analytics only; never shown to the user."
}
},
"required": [
"rate_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"rate_id": {
"type": "string"
},
"hotel_name": {
"type": [
"string",
"null"
]
},
"room_name": {
"type": [
"string",
"null"
]
},
"check_in": {
"type": [
"string",
"null"
],
"description": "YYYY-MM-DD"
},
"check_out": {
"type": [
"string",
"null"
],
"description": "YYYY-MM-DD"
},
"adults": {
"type": "integer"
},
"board_type": {
"type": "string"
},
"price": {
"type": "number"
},
"currency": {
"type": "string"
},
"refundability": {
"type": "string",
"enum": [
"fully_refundable",
"partially_refundable",
"non_refundable"
]
},
"cancellation_deadline": {
"type": [
"string",
"null"
]
},
"image_urls": {
"type": "array",
"items": {
"type": "string"
},
"description": "Up to 5 room (else hotel) photos; for the checkout view, not sent to the model"
},
"guest": {
"type": "object",
"description": "The guest details passed in, to prefill the form",
"properties": {
"first_name": {
"type": "string"
},
"last_name": {
"type": "string"
},
"email": {
"type": "string"
},
"phone": {
"type": "string"
},
"title": {
"type": "string"
},
"nationality": {
"type": "string"
}
}
},
"payment_service": {
"type": [
"string",
"null"
],
"enum": [
"coingate",
"x402",
null
]
},
"title_suggestion": {
"type": [
"string",
"null"
],
"enum": [
"MR",
"MRS",
"MS",
"MISS",
null
],
"description": "Preselected in the form as a suggestion when no title was passed"
},
"next_step": {
"type": "string",
"description": "Whether the form books, or booking continues in chat"
},
"payment_quotes": {
"type": "object",
"description": "What each payment method charges for this stay, in the currency it charges in",
"properties": {
"coingate": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "number"
},
"currency": {
"type": "string"
}
},
"required": [
"amount",
"currency"
]
},
"x402": {
"type": [
"object",
"null"
],
"properties": {
"amount": {
"type": "number"
},
"currency": {
"type": "string"
}
},
"required": [
"amount",
"currency"
]
}
}
}
},
"required": [
"rate_id",
"hotel_name",
"room_name",
"check_in",
"check_out",
"adults",
"board_type",
"price",
"currency",
"refundability",
"cancellation_deadline",
"image_urls",
"guest",
"payment_service",
"title_suggestion",
"payment_quotes",
"next_step"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴purchase_hotel(rate_id, first_name, last_name, email, phone, ...)
Book a hotel room in chat, by providing guest details and a rate ID from get_hotel_details. Use start_checkout instead, which opens a booking form; call this only when the user says they cannot see or use that form. Creates a guest profile, adds the room to a cart, and initiates checkout. Ask the user how they want to pay before calling, and pass it as payment_service: 'x402' (USDC on Base, paid by an x402 payments tool you have) or 'coingate' (a checkout page the user pays in their browser, any crypto). If you have no x402 payments tool, use coingate. Returns a payment_url and the cart_url where the order can also be paid in a browser. The booking is confirmed once payment settles; poll get_order_details to check status.
输入模式
{
"type": "object",
"properties": {
"rate_id": {
"type": "string",
"description": "Signed rate ID from get_hotel_details response"
},
"first_name": {
"type": "string",
"description": "Guest's first name"
},
"last_name": {
"type": "string",
"description": "Guest's last name"
},
"email": {
"type": "string",
"description": "Guest's email address"
},
"phone": {
"type": "string",
"description": "Guest's phone number (e.g., +44123456789)"
},
"nationality": {
"type": "string",
"description": "Guest's nationality as ISO 3166-1 alpha-2 code (default: GB)"
},
"title": {
"type": "string",
"description": "Guest's title: MR, MRS, MS, or MISS (default: MR)",
"enum": [
"MR",
"MRS",
"MS",
"MISS"
]
},
"price_currency": {
"type": "string",
"description": "Payment currency (default: USD for x402, EUR for coingate). Supported: EUR, USD, GBP, PLN, CZK, HUF, SEK, NOK, DKK"
},
"payment_service": {
"type": "string",
"description": "Payment method the user chose: x402 (USDC on Base, needs an x402 payments tool; default) or coingate (browser checkout, any crypto)",
"enum": [
"x402",
"coingate"
]
},
"context": {
"type": "string",
"maxLength": 200,
"description": "Why are you calling this tool? Describe the user's underlying goal in one short sentence — not the tool name. Never include names, emails, phones, or prices. Always pass this. Used for analytics only; never shown to the user."
}
},
"required": [
"rate_id",
"first_name",
"last_name",
"email",
"phone"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"cart_id": {
"type": "string",
"description": "Pass to get_order_details to poll the booking"
},
"booking_reference": {
"type": [
"string",
"null"
]
},
"payment_url": {
"type": [
"string",
"null"
]
},
"cart_url": {
"type": "string",
"description": "The order on trip1, where it can also be paid in a browser"
},
"message": {
"type": "string",
"description": "How to complete payment for the chosen payment_service"
}
},
"required": [
"cart_id",
"booking_reference",
"payment_url",
"cart_url",
"message"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢pay_order(cart_id, context)
Open CoinGate's checkout page for an unpaid CoinGate booking, so the user can pay in their browser. Pass the cart_id from purchase_hotel or the booking form. Where the client supports it, this asks the client to open the page for the user (URL elicitation); otherwise, and once the page has been offered, it returns the order with its payment link. Not for x402 bookings, which your payments tool pays.
输入模式
{
"type": "object",
"properties": {
"cart_id": {
"type": "string",
"description": "The cart_id from purchase_hotel or the booking form"
},
"context": {
"type": "string",
"maxLength": 200,
"description": "Why are you calling this tool? Describe the user's underlying goal in one short sentence — not the tool name. Never include names, emails, phones, or prices. Always pass this. Used for analytics only; never shown to the user."
}
},
"required": [
"cart_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"ready": {
"type": "boolean",
"description": "true once payment settled and the booking is purchased — stop polling"
},
"cart_url": {
"type": "string"
},
"payment": {
"type": [
"object",
"null"
],
"properties": {
"state": {
"type": "string"
},
"service": {
"type": "string"
},
"amount": {
"type": "number"
},
"currency": {
"type": "string"
},
"transaction_hash": {
"type": "string"
},
"payment_url": {
"type": "string",
"description": "Where an unpaid payment is completed"
}
},
"required": [
"state",
"service",
"amount"
]
},
"booking": {
"type": [
"object",
"null"
],
"properties": {
"state": {
"type": "string"
},
"booking_reference": {
"type": [
"string",
"null"
]
},
"contact": {
"type": [
"object",
"null"
],
"properties": {
"first_name": {
"type": "string"
},
"last_name": {
"type": "string"
},
"email": {
"type": "string"
}
},
"required": [
"first_name",
"last_name",
"email"
]
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"state": {
"type": "string"
},
"hotel_name": {
"type": "string"
},
"room_name": {
"type": "string"
},
"price": {
"type": "number"
},
"currency": {
"type": "string"
},
"provider_reference": {
"type": "string"
},
"check_in": {
"type": "string",
"description": "YYYY-MM-DD"
},
"check_out": {
"type": "string",
"description": "YYYY-MM-DD"
},
"board_type": {
"type": "string"
},
"image_urls": {
"type": "array",
"items": {
"type": "string"
},
"description": "Up to 5 hotel photos; for the order view, not sent to the model"
}
},
"required": [
"state",
"price"
]
}
}
},
"required": [
"state",
"booking_reference",
"contact",
"items"
]
}
},
"required": [
"ready",
"cart_url",
"payment",
"booking"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_order_details(cart_id, context)
Get the current state of an order. Returns payment status, booking state, and item details. Poll until ready is true to confirm the booking is complete.
输入模式
{
"type": "object",
"properties": {
"cart_id": {
"type": "string",
"description": "The cart_id from purchase_hotel response"
},
"context": {
"type": "string",
"maxLength": 200,
"description": "Why are you calling this tool? Describe the user's underlying goal in one short sentence — not the tool name. Never include names, emails, phones, or prices. Always pass this. Used for analytics only; never shown to the user."
}
},
"required": [
"cart_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"ready": {
"type": "boolean",
"description": "true once payment settled and the booking is purchased — stop polling"
},
"cart_url": {
"type": "string"
},
"payment": {
"type": [
"object",
"null"
],
"properties": {
"state": {
"type": "string"
},
"service": {
"type": "string"
},
"amount": {
"type": "number"
},
"currency": {
"type": "string"
},
"transaction_hash": {
"type": "string"
},
"payment_url": {
"type": "string",
"description": "Where an unpaid payment is completed"
}
},
"required": [
"state",
"service",
"amount"
]
},
"booking": {
"type": [
"object",
"null"
],
"properties": {
"state": {
"type": "string"
},
"booking_reference": {
"type": [
"string",
"null"
]
},
"contact": {
"type": [
"object",
"null"
],
"properties": {
"first_name": {
"type": "string"
},
"last_name": {
"type": "string"
},
"email": {
"type": "string"
}
},
"required": [
"first_name",
"last_name",
"email"
]
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"state": {
"type": "string"
},
"hotel_name": {
"type": "string"
},
"room_name": {
"type": "string"
},
"price": {
"type": "number"
},
"currency": {
"type": "string"
},
"provider_reference": {
"type": "string"
},
"check_in": {
"type": "string",
"description": "YYYY-MM-DD"
},
"check_out": {
"type": "string",
"description": "YYYY-MM-DD"
},
"board_type": {
"type": "string"
},
"image_urls": {
"type": "array",
"items": {
"type": "string"
},
"description": "Up to 5 hotel photos; for the order view, not sent to the model"
}
},
"required": [
"state",
"price"
]
}
}
},
"required": [
"state",
"booking_reference",
"contact",
"items"
]
}
},
"required": [
"ready",
"cart_url",
"payment",
"booking"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}社区
证据