1stay

Name: 1stay
Author: STAYKER-COM

STAYKER-COM/1Stay-mcp

2 repo stars
Updated May 26, 2026
STAYKER-COM/1Stay-mcp

Hotel booking MCP server. Search, book, and manage reservations across 250K+ properties worldwide.

About

Hotel booking MCP server. Search, book, and manage reservations across 250K+ properties worldwide. © 2026 WPF Holdings, LLC. All rights reserved. Exposes 8 MCP tools including com.stayker/1stay, | Tool | Description | Annotations |, |------|-------------|-------------|, | `cancel_booking` | Cancel an existing reservation | `destructiveHint. Install via Claude Desktop, Cursor, or any MCP-compatible client using the upstream server manifest.

**MCP Endpoint:** `https://mcp.stayker.com/mcp`
**Protocol:** Streamable HTTP | MCP SDK v1.27.1 | Latest protocol version `2025-11-25`
**Supported versions:** `2025-11-25`, `2025-06-18`, `2025-03-26`, `2024-11-05`, `2024-10-07`
**300,000+ properties** across 140+ countries - major chains, independents, boutiques
**Real confirmation numbers** - not affiliate links, not redirects

1stay by the numbers

Exposes 8 verified tools (MCP introspection)
Data as of Jul 22, 2026 (Skillselion catalog sync)

terminal

claude mcp add --transport http 1stay https://mcp.stayker.com/mcp

Add your badge

Show developers this MCP server is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/mcp/tool/com.stayker/1stay.svg)](https://skillselion.com/mcp/tool/com.stayker/1stay)

repo stars	★ 2
Transport	HTTP
Auth	None
Tools	8
Last updated	May 26, 2026
Repository	STAYKER-COM/1Stay-mcp ↗

How do I connect 1stay to my MCP client?

Hotel booking MCP server. Search, book, and manage reservations across 250K+ properties worldwide.

Who is it for?

Teams wiring 1stay into Claude, Cursor, or custom agents for developer tools.

Skip if: Skip when you need a non-MCP SDK or hosted API without stdio/SSE transport.

What you get

Working 1stay MCP server with verified tool registration and client config.

Agent-driven hotel search results tied to Stayker inventory
Booking and reservation management actions via MCP tools
Faster travel-feature MVP without custom aggregator plumbing

By the numbers

[object Object]

At a glance

1stay capabilities & compatibility

Capabilities: 1stay mcp tool registration · 1stay client configuration · 1stay agent workflow integration
Use cases: orchestration
Runs: Remote server

From the docs

What 1stay says it does

Hotel booking MCP server. Search, book, and manage reservations across 250K+ properties worldwide.

README.md

Hotel booking MCP server. Search, book, and manage reservations across 250K+ properties worldwide.

README.md

Tools 8

Public tool metadata - what this server can do for an agent.

search_hotels13 params

Search and book hotels by location and dates. Returns available properties with nightly rates across major brands, boutique, and independent hotels. Guest pays the hotel directly. Hotel's own confirmation number. Loyalty points apply.

locationstringrequiredCity, address, venue, or landmark (e.g. 'Nashville, TN' or 'Times Square, NYC'). Required for all searches.
latitudenumberLatitude — must be provided together with longitude
longitudenumberLongitude — must be provided together with latitude
check_instringrequiredCheck-in date in YYYY-MM-DD format (e.g. 2026-05-06). Must be today or later.
check_outstringrequiredCheck-out date in YYYY-MM-DD format (e.g. 2026-05-07). Must be after check_in.
guests_per_roomintegerGuests per room (default 2)
roomsintegerNumber of rooms (default 1)
radiusintegerSearch radius in miles (default 25, max 100)
chain_codestringTwo-letter hotel chain filter. MC=Marriott, HH=Hilton, HI=IHG, YX=Hyatt, BW=Best Western, WY=Wyndham, EL=Choice. Omit for boutique, independent, or unbranded searches.
currencystringCurrency code (default USD)
max_resultsintegerMax hotels to return, max 15 (default 10)
search_idstringSearch ID from previous results — pass with cursor for next page
cursorstringPagination cursor from previous search response

get_hotel_details5 params

Get rates and room details for a specific hotel. Returns room types, live rates, amenities, cancellation policies, and rate_codes required by book_hotel. Guest pays the hotel directly. Rates shown are what the hotel charges. A 1Stay Booking Fee is added at checkout. Loyalty points eligible. Room type notes: "Run of house" means the hotel assigns the room at check-in. "Suite" at select-service brands usually means a larger room with a sofa, not a separate bedroom. Non-refundable rates are cheaper but cannot be changed or canceled.

hotel_idstringrequiredHotel ID from search results
check_instringrequiredCheck-in date in YYYY-MM-DD format (e.g. 2026-05-06)
check_outstringrequiredCheck-out date in YYYY-MM-DD format (e.g. 2026-05-07)
guestsintegerNumber of guests (default 2)
roomsintegerNumber of rooms (default 1)

book_hotel8 params

Book a hotel room. Returns a secure checkout URL where the guest completes payment. Do not collect credit card numbers, payment info, or billing details in conversation. Guest pays the hotel directly. Their credit card statement shows the hotel name, not 1Stay. Hotel's own confirmation number. Loyalty points apply automatically. A 1Stay Booking Fee is added at checkout. Requires rate_code from get_hotel_details (expires in approximately 15 minutes). If expired, call get_hotel_details again for a fresh code.

hotel_idstringrequiredHotel ID from search or details
rate_codestringrequiredRate code from get_hotel_details — you MUST call get_hotel_details first to get a valid rate_code before booking
check_instringrequiredCheck-in date in YYYY-MM-DD format (e.g. 2026-05-06)
check_outstringrequiredCheck-out date in YYYY-MM-DD format (e.g. 2026-05-07)
guestsintegerrequiredNumber of guests
guest_namestringrequiredGuest full name
guest_emailstringrequiredGuest email for confirmation
external_reference_idstringYour unique reference ID for this booking (for idempotency and retrieval)

lookup_booking6 params

Look up a reservation by verifying the guest's identity. Returns the confirmation number and booking summary in conversation. Required before calling: 1. Guest full name (first and last) 2. At least one verification factor: email address used when booking, hotel confirmation number, or last 4 digits of the card used to book (check-in date also required for card verification) Do not call this tool without the guest's full name and at least one verification factor. If the guest cannot provide any verification factor, their reservation cannot be looked up — this is for the security of their booking. To resend the confirmation email, use resend_confirmation after verifying identity with this tool. To cancel, use cancel_booking.

first_namestringrequiredGuest first name on the reservation
last_namestringrequiredGuest last name on the reservation
confirmation_numberstringHotel confirmation number
emailstringEmail address used when booking
last_four_cardstringLast 4 digits of the card used to book
check_in_datestringCheck-in date (YYYY-MM-DD) — required with last_four_card

resend_confirmation2 params

Resend a hotel reservation confirmation email. Use after verifying the guest's identity with lookup_booking. Sends the full confirmation to the email address on file. If the guest needs it sent to a different email (typo on original, or can't access it), provide updated_email.

confirmation_numberstringrequiredHotel confirmation number
updated_emailstringIf provided, send confirmation to this email instead of the one on file. Use when guest typo'd their email at booking or can't access the original email.

get_booking1 param

Look up a reservation by booking ID (stk_bk_xxxx) or hotel confirmation number. Returns full booking details including hotel, dates, guest info, rate, and status. Developer-level lookup tool with no identity verification. For guest-facing reservation lookups, use lookup_booking which enforces identity verification before returning any data.

booking_idstringrequiredBooking ID (e.g. stk_bk_xxxx) or confirmation number

cancel_booking3 params

Cancel a hotel reservation. This action cannot be undone. Requires guest first name, last name, and hotel confirmation number. Cancellation of non-refundable rates forfeits the full amount. The guest should be aware of the cancellation policy before this tool is called. To change dates: the recommended pattern is to search and book new dates first, then cancel the original reservation. Canceling before securing a new booking risks losing the room. Cancellation confirmation is emailed to the address on file.

first_namestringrequiredGuest first name on the reservation
last_namestringrequiredGuest last name on the reservation
confirmation_numberstringrequiredHotel confirmation number

search_tools1 param

List available 1Stay hotel booking tools. Filter by keyword: search, book, cancel, details. Omit keyword to list all tools.

keywordstringKeyword to filter tools (e.g. 'book', 'search', 'cancel'). Omit to list all tools.

README.md

1Stay — Hotel Booking via MCP

The first MCP server that completes real hotel reservations inside AI conversations. Not search-and-redirect. Not affiliate links. A confirmed booking with a real confirmation number — where your loyalty points accrue and your elite status benefits apply.

Builders monetize every booking via Stripe Connect — set your own fee, get paid directly. Turn any AI agent into a revenue-generating travel assistant.

Built by Stayker (WPF Holdings, LLC), a licensed travel technology company built on proven travel distribution architecture. When you book through 1Stay, the hotel is the merchant of record — your stay is treated exactly like a direct booking.

Quick Start

npx (fastest)

npx 1stay-mcp

Claude Desktop / ChatGPT / Cursor / Windsurf

Add to your MCP configuration:

{
  "mcpServers": {
    "1stay": {
      "url": "https://mcp.stayker.com/mcp"
    }
  }
}

Claude Code

claude mcp add 1stay --transport http https://mcp.stayker.com/mcp

Try It Now

Playground: 1stay.ai/playground — test all 8 tools in your browser, no setup required.

MCP Endpoint: https://mcp.stayker.com/mcp Protocol: Streamable HTTP | MCP SDK v1.27.1 | Latest protocol version 2025-11-25 Supported versions: 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05, 2024-10-07

Features

300,000+ properties across 140+ countries — major chains, independents, boutiques
Real confirmation numbers — not affiliate links, not redirects
Loyalty program eligible — Hilton, Marriott, IHG points accrue, elite status applies
Stripe Connect monetization — builders set their own booking fee and get paid directly
Secure checkout — payment handled on PCI-compliant page, never in the AI conversation
Live rates — real-time pricing from travel distribution networks, not cached or scraped

Tools

Tool	Description	Annotations
`search_hotels`	Search hotels by location, dates, guests, and optional filters	`readOnlyHint: true`
`get_hotel_details`	Get room types, amenities, images, and live rates for a specific property	`readOnlyHint: true`
`book_hotel`	Create a reservation and receive a secure checkout URL	`idempotentHint: true`
`lookup_booking`	Look up a reservation with identity verification	`readOnlyHint: true`
`resend_confirmation`	Resend confirmation email to guest	`openWorldHint: true`
`get_booking`	Look up a reservation by booking ID or confirmation number	`readOnlyHint: true`
`cancel_booking`	Cancel an existing reservation	`destructiveHint: true`
`search_tools`	List available 1Stay tools, optionally filtered by keyword	`readOnlyHint: true`

For Builders — Monetize with Stripe Connect

1Stay lets developers and AI builders earn on every hotel booking their agent completes. Connect your Stripe account, set your booking service fee, and get paid directly when guests check out.

Get started: 1stay.ai/apply

Authentication

1Stay uses OAuth 2.0 authorization code flow. When connecting through Claude, the OAuth handshake is handled automatically. You'll need a valid 1Stay account to authenticate.

How Booking Works

1Stay uses a secure link handoff model for payment:

Search and select happen inside the AI conversation
Guest details (name, email, phone) are collected in conversation to create the reservation
Payment is completed on a secure, PCI-compliant checkout page — outside the AI layer
Confirmation is delivered via email with your hotel confirmation number

Credit card and payment information never passes through the AI conversation. The checkout URL is valid for approximately 30 minutes.

Examples

Search hotels for an upcoming trip

User prompt: "I need a hotel in downtown Charlotte for May 7-10, two adults."

1Stay searches available properties, returns hotels with nightly rates, star ratings, and distance from city center. Ask follow-ups to narrow by price, brand, or amenities.

Get details and book a room

User prompt: "Show me room options, then book the king room."

1Stay retrieves live room types, rates, and cancellation policies. Provide guest name, email, and phone — 1Stay creates the reservation and returns a secure checkout URL.

Look up and manage a reservation

User prompt: "I need to look up my reservation — Amy Barker, amy@stayker.com"

1Stay verifies your identity and returns the confirmation number and booking summary in conversation. Ask to resend the confirmation email or cancel directly in conversation.

Coming Soon

Event-aware inventory — search and book around tournaments, weddings, and conferences with venue-based search and organizer tools
SMS concierge — opt-in post-booking updates and itinerary support via text
Multi-room coordination — group booking tools for teams, families, and event attendees

Privacy & Legal

Privacy policy: stayker.com/legal/privacy
MCP data policy: stayker.com/legal/mcp-policy

Support

Chat: stayker.com/service
Issues: github.com/STAYKER-COM/1Stay-mcp/issues
Docs: 1stay.ai

About Stayker

Stayker is a travel technology company that powers hotel reservations for events, organizations, and brands. Built on proven travel distribution architecture — live worldwide inventory, no middlemen, no markups, no affiliate redirects. Hotels are the merchant of record on every booking.

Headquarters: Charlotte, NC

Build. Book. Connect.

License

Versions 1.1.0 and earlier were distributed under the MIT License and remain available under those terms to anyone who obtained them under that license.

Use of the hosted MCP endpoint at https://mcp.stayker.com/mcp is governed by the Stayker MCP Policy.