trip1

npx add-mcp 'https://trip1.com/api/mcp'

trip1 for AI agents

Book hotels from your agent

trip1 exposes hotel search, rates, and booking as MCP tools. Roughly 3 million properties in 200+ countries, paid in USDC on Base through x402. Settlement happens inside the same HTTP request the agent already made.

Install trip1 See how it works

Claude Desktop Claude Code ChatGPT Other

Install through the Claude Desktop UI:

1. 01Open Settings → Customize → Plugins.
2. 02Click Add marketplace and enter trivial-corp/agents.
3. 03Find trip1 in the marketplace list and click Install.

Exact steps differ between Pro, Max, Team, and Enterprise. Anthropic's connector setup guide covers each plan.

Paste into any Claude Code session. Installs the MCP server and the hotel-booking skill together.

/plugin marketplace add trivial-corp/agents

/plugin install trip1@trivial-corp/agents

Requires Pro, Team, Enterprise, or Edu (Developer Mode).

1. 01Open Settings → Apps & Connectors → Advanced settings and enable Developer Mode.
2. 02Back under Apps & Connectors, click Add new connector.
3. 03Name trip1, paste the URL below, set Auth to None.

https://trip1.com/api/mcp

OpenAI MCP docs.

Any client that speaks remote MCP (Cursor, Codex CLI, Gemini CLI, Cowork, and so on) accepts this config:

mcp.json

{
  "mcpServers": {
    "trip1": {
      "type": "http",
      "url": "https://trip1.com/api/mcp"
    }
  }
}

The flow

From search to a confirmed booking

The agent runs every step itself, from the first search to the supplier's reservation reference.

Hotels

3M+ properties

Coverage

200+ countries

Settlement

USDC on Base, ~2s

trip1 MCP demo

1. 01

   Search

   Agent queries hotels by destination and dates (occupancy is fixed at 2 adults).

2. 02

   Compare

   Pulls rooms, rates, and live availability for a chosen hotel.

3. 03

   Book

   Creates the reservation with guest details and a rate ID.

4. 04

   Pay

   Signs a USDC transfer on Base via x402. The facilitator submits it and confirms settlement, usually in about two seconds.

5. 05

   Confirm

   Polls the order until the supplier returns a reservation reference.

Tools

Four tools, called in order

Every tool ships with a full JSON schema, read/write annotations, and a description the agent reads before calling it. No guesswork.

search_hotels

Look up hotels for a destination and date range. Sort by price, rating, or distance to the search center.

get_hotel_details

Fetch room types, nightly rates, cancellation terms, and live availability for one hotel.

purchase_hotel

Create a reservation with guest details and a rate ID from get_hotel_details. Returns the x402 challenge, or a CoinGate URL as a fallback.

get_order_details

Fetch an order by ID. Poll after paying; the supplier reference appears once the booking clears.

Prompts the skill handles end to end

Paste any of these into a session that has trip1 installed. The agent searches, compares rates, collects guest details, confirms with you, and settles the payment on its own.

• >Find me a hotel in Barcelona for May 30 to 31.
• >What's the cheapest hotel near Bairro Alto in Lisbon this weekend?
• >Three nights in Shibuya starting Friday. Pick something well-reviewed and book it.
• >Check the Barcelona booking. Poll until the supplier reference comes through.

Payment

Agents pay over x402

x402 is the open protocol for agentic payments. It revives HTTP 402 for programmatic use: when the agent calls purchase_hotel, trip1 responds with a payment challenge; the agent signs a USDC authorization on Base and retries. A facilitator submits the transfer, and the booking continues as soon as it clears. The agent handles everything on its own, with no wallet UI to click through.

The agent needs an x402-capable wallet to pay on its own. The simplest option is Coinbase Payments MCP, loaded alongside trip1:

npx @coinbase/payments-mcp

Without a payments MCP attached, purchase_hotel returns a CoinGate URL instead. You can finish the payment yourself in a browser, with any of 120+ cryptocurrencies, including USDC.

Skill

A skill ships with the plugin

The MCP server ships tools. The skill ships judgment: when to fire, which tool to call next, how to confirm booking details with the user, how to recover when a rate drops between search and checkout. The Claude Desktop and Claude Code installs above bundle the skill automatically.

For clients that read the universal SKILL.md format (Cursor, Codex CLI, Gemini CLI), add it on its own:

npx skills add trivial-corp/agents

ChatGPT and other remote-MCP-only surfaces don't load SKILL.md. The tool descriptions on the server carry enough intent on their own.

In your browser

WebMCP: tools on trip1.com itself

WebMCP lets a web page hand an agent in the browser a set of described tools. trip1.com registers them through document.modelContext, so the agent searches, reads rates, guides and help, saves hotels and opens checkout as the person using the page, instead of guessing at buttons. The tools change with the page, like the page itself.

It sits alongside the MCP server above rather than replacing it. The MCP server is for agents that work outside a browser and pay over x402. WebMCP runs inside the user's own session, and paying is always the user's step on the checkout page.

Experimental

Chrome is testing WebMCP in an origin trial (Chrome 149 to 156) that trip1.com is enrolled in, and the standard may still change.

Try it

1. 01Install a WebMCP agent extension such as the Model Context Tool Inspector.
2. 02The Inspector reads Chrome's own WebMCP, which it needs switched on: in Chrome 150 or later, open chrome://flags, set WebMCP for testing to Enabled and relaunch. Extensions that bring their own WebMCP skip this.
3. 03Open trip1.com and ask the agent to plan a stay.

The tools, page by page

read-only

Reads the page and changes nothing.

changes the page

Navigates or edits the search, as a click would.

consequential

Acts for the user: holds rooms, types their details into a form or edits their saved list. Paying stays the user's step.

Every page3 tools

get_page_contextread-only

Where the user is, sign-in state, currency, and the tools this page offers.

navigate_tochanges the page

Open a trip1 section.

search_hotelschanges the page

Search by destination, dates, rooms and guests, and open the results.

Every page: guides and help4 tools

find_articlesread-only

Travel guides and blog posts, newest first, by destination or topic.

open_articlechanges the page

Open a guide or blog post.

search_help_articlesread-only

Search the help centre: booking, crypto payments, cancellations.

get_help_articleread-only

A help article as plain text.

Every page: account2 tools

get_account_statusread-only

Whether the user is signed in, and nothing about who they are.

open_sign_inchanges the page

Open the sign-in dialog. The user signs in themselves; the agent never handles credentials.

Search results4 tools

get_search_resultsread-only

The hotels on the page with live prices for the whole stay and coordinates, paged with offset.

get_available_filtersread-only

The filters this search can be refined by, including its price range.

refine_searchchanges the page

Change stars, amenities, price, sort, radius, dates or guests.

open_hotelchanges the page

Open a hotel from the results, or any trip1 hotel by its slug.

Hotel page4 tools

get_hotel_detailsread-only

Description, location, amenities and policies.

get_hotel_reviewsread-only

Guest reviews, newest first, with the average score.

check_hotel_availabilitychanges the page

Run a live availability search for other dates or guests.

save_hotelconsequential

Add the hotel to the user's saved list, or remove it. Needs the user signed in.

Hotel page, once dates are set2 tools

get_room_ratesread-only

Every bookable room with board, cancellation terms and the stay price.

select_ratesconsequential

Hold the chosen rooms and open checkout. Nothing is charged.

Checkout2 tools

get_checkout_summaryread-only

Hotel, dates, rooms, cancellation terms, total, whether the guests are filled, and what is left. The user accepts the terms and pays.

prefill_contactconsequential

Types the contact person's details into the form. It never saves: the user checks them and presses Save contact.

Account, signed in2 tools

get_bookingsread-only

The user's bookings: reference, hotel, dates, status and total. No guest details.

open_bookingchanges the page

Open a booking by its reference.

Booking1 tools

get_booking_detailsread-only

Rooms, status, cancellation terms and the refund estimate. Cancelling stays with the user.

Travel guide or blog post3 tools

get_articleread-only

The article as plain text: dates, sections, the hotels it links to, and its FAQ.

open_hotelchanges the page

Open a hotel the article links to.

save_travel_guideconsequential

Travel guides only: add the guide to the user's saved list, or remove it. Needs the user signed in.

TSA wait-time pages2 tools

find_tsa_airportsread-only

Find airports by code, city or alias and get canonical airport links.

get_tsa_wait_timesread-only

Cached waits with live/estimated labels, source timestamps, checkpoint guidance and FAQs.

How WebMCP works on trip1, with a real trip planned by Gemini through the Inspector.

Questions that come up

Do I need a crypto wallet to use trip1?

trip1 is crypto-native, so there is always a wallet somewhere in the flow. As a human, CoinGate gives you a hosted checkout URL where you pay with any of 120+ cryptocurrencies, including USDC. Agents pay on their own over x402 when an x402-capable wallet MCP (like Coinbase Payments MCP) is loaded alongside trip1.

What happens if the rate changes between search and booking?

trip1 returns an explicit "rate no longer available" error. The skill instructs the agent to rerun search_hotels and get_hotel_details with fresh rate IDs. It never auto-substitutes silently.

Does trip1 store agent or user payment credentials?

No. trip1 is a non-custodial merchant endpoint. x402 transfers settle on-chain through a facilitator the agent picks. CoinGate handles the browser-based flow and trip1 never sees card or wallet details.

Which MCP protocol version does the server speak?

Streamable HTTP, spec version 2025-06-18, stateless mode. Works with every modern MCP client (Claude Desktop, Claude Code, ChatGPT, Cursor, Codex CLI, Gemini CLI).

Can I cancel a booking after it's confirmed?

Cancellation depends on the rate. get_hotel_details returns each rate's cancellation terms before you book, and the skill flags non-refundable rates explicitly. For post-booking changes, contact trip1 support with the booking reference.

Is there a rate limit on the MCP server?

trip1 rate-limits by IP and by signed session. For agents running at scale, contact us before launching so we can bump the quota.

Crypto checkout, now for agents

trip1 has taken crypto payments from humans since 2025. The MCP server just lets an agent do the same thing.

Browse hotels Plugin source on GitHub

{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://trip1.com/#organization","name":"trip1","url":"https://trip1.com","logo":{"@type":"ImageObject","@id":"https://trip1.com/#logo","url":"https://trip1.com/trip1-logo.png"},"image":{"@id":"https://trip1.com/#logo"},"description":"trip1 is a hotel booking platform that helps travelers find and book accommodations from 3M+ hotels worldwide. Pay with crypto.","foundingDate":"2025","founder":{"@type":"Person","name":"Tomas Achmedovas","url":"https://trip1.com/authors/tomas-achmedovas"},"address":{"@type":"PostalAddress","addressLocality":"Vilnius","addressCountry":"LT"},"email":"support@trip1.com","numberOfEmployees":{"@type":"QuantitativeValue","minValue":2,"maxValue":10},"sameAs":["https://www.instagram.com/trip1com","https://www.facebook.com/trip1com","https://x.com/trip1com","https://www.linkedin.com/company/trip1","https://github.com/trivial-corp","https://www.trustpilot.com/review/trip1.com","https://coingate.com/stores/trip1","https://smithery.ai/servers/trip1/trip1"],"contactPoint":{"@type":"ContactPoint","contactType":"customer support","url":"https://trip1.com/help"}},{"@type":"WebSite","@id":"https://trip1.com/#website","name":"trip1","url":"https://trip1.com","description":"Find and book hotels effortlessly with trip1. Compare deals from 3M+ hotels worldwide and pay with crypto.","publisher":{"@id":"https://trip1.com/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://trip1.com/search/hotels?query={search_term_string}"},"query-input":"required name=search_term_string"}},{"@type":"WebAPI","@id":"https://trip1.com/agents#mcp","name":"trip1 MCP server","description":"trip1 MCP server lets AI agents book hotels and pay with USDC on Base via x402. 3M+ hotels, settled on-chain in seconds. Works with Claude, ChatGPT, and any MCP client.","url":"https://trip1.com/agents","documentation":"https://trip1.com/agents","provider":{"@id":"https://trip1.com/#organization"}},{"@type":"WebAPI","@id":"https://trip1.com/agents#webmcp","name":"trip1 WebMCP tools","description":"Experimental. trip1.com pages register tools for searching hotels, reading results, hotel details and room rates, travel guides, blog posts and help articles, and saving hotels, with document.modelContext, for agents running in the user’s browser (Chrome origin trial, Chrome 149 to 156).","url":"https://trip1.com/agents#webmcp","documentation":"https://trip1.com/blog/trip1-webmcp-ai-agents","provider":{"@id":"https://trip1.com/#organization"}},{"@type":"SoftwareApplication","@id":"https://trip1.com/agents#app","name":"trip1 MCP server","description":"trip1 MCP server lets AI agents book hotels and pay with USDC on Base via x402. 3M+ hotels, settled on-chain in seconds. Works with Claude, ChatGPT, and any MCP client.","url":"https://trip1.com/agents","applicationCategory":"TravelApplication","operatingSystem":"Any","installUrl":"https://trip1.com/agents","softwareHelp":{"@id":"https://trip1.com/agents#mcp"},"offers":{"@type":"Offer","price":"0","priceCurrency":"USD"},"author":{"@id":"https://trip1.com/#organization"},"sameAs":["https://smithery.ai/servers/trip1/trip1","https://github.com/trivial-corp/agents"]}]}