# 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](https://stayker.com) (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.

[![npm version](https://img.shields.io/npm/v/1stay-mcp)](https://www.npmjs.com/package/1stay-mcp)
[![1Stay Hotel Booking MCP server](https://glama.ai/mcp/servers/STAYKER-COM/1Stay-mcp/badges/card.svg)](https://glama.ai/mcp/servers/STAYKER-COM/1Stay-mcp)
[![1Stay-mcp MCP server](https://glama.ai/mcp/servers/STAYKER-COM/1Stay-mcp/badges/score.svg)](https://glama.ai/mcp/servers/STAYKER-COM/1Stay-mcp)

## Quick Start

### npx (fastest)

```bash
npx 1stay-mcp
```

### Claude Desktop / ChatGPT / Cursor / Windsurf

Add to your MCP configuration:
```json
{
  "mcpServers": {
    "1stay": {
      "url": "https://mcp.stayker.com/mcp"
    }
  }
}
```

### Claude Code

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

### Try It Now

**Quickstart:** [1stay.ai/docs/quickstart](https://1stay.ai/docs/quickstart) — hotel booking for AI agents in three calls.

**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

- **250,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 and dates for one room (up to 6 results per page, paginated) | `readOnlyHint: true` |
| `get_hotel_details` | Get room types, amenities, images, and live rates for a specific property | `readOnlyHint: true` |
| `book_hotel` | Create a booking for one room and receive a secure checkout URL (no guest identity or payment fields) | `idempotentHint: true` |
| `lookup_booking` | Look up a reservation by full name plus confirmation number, or booking email with card last four | `readOnlyHint: true` |
| `resend_confirmation` | Resend the confirmation email to the address on file (by confirmation number, or full name and email) | `openWorldHint: true` |
| `get_booking` | Look up a reservation by hotel confirmation number | `readOnlyHint: true` |
| `cancel_booking` | Verify the guest and return a secure cancellation link — the guest completes the cancellation on that page | `idempotentHint: 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](https://1stay.ai/apply)

## Authentication

No sign-in is required. The hosted endpoint is authless — connect with the URL above and start searching. No 1Stay account or OAuth flow is needed. Developers with a 1Stay API key can send it as a Bearer token.

## How Booking Works

1Stay uses a **secure link handoff** model for payment:

1. **Search and select** happen inside the AI conversation
2. **Checkout link** — the agent creates the booking with the selected rate and receives a secure checkout URL
3. **Guest details and payment** (name, email, phone, card) are entered on a secure, PCI-compliant checkout page — outside the AI layer
4. **Confirmation** is delivered via email with your hotel confirmation number

Guest identity and payment information never pass through the AI conversation. The checkout URL is valid for ~15 minutes — if it expires, fetch fresh rates and create a new checkout link.

## 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, then returns a secure checkout URL for the selected room. The guest enters their details and payment on that page.

### Look up and manage a reservation

**User prompt:** "I need to look up my reservation — Jane Smith, confirmation number 83920471"

1Stay verifies your identity — full name plus your hotel confirmation number, or your booking email together with the last four digits of the card used to book — and returns the confirmation number and booking summary in conversation. Ask to resend the confirmation email, or ask to cancel and 1Stay returns a secure link where you review the terms and complete the cancellation.

## 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](https://stayker.com/legal/privacy)
- MCP data policy: [stayker.com/legal/mcp-policy](https://stayker.com/legal/mcp-policy)

## Support

- **Chat:** [stayker.com/service](https://stayker.com/service)
- **Issues:** [github.com/STAYKER-COM/1Stay-mcp/issues](https://github.com/STAYKER-COM/1Stay-mcp/issues)
- **Docs:** [1stay.ai](https://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

Proprietary. © 2026 WPF Holdings, LLC. All rights reserved. See [LICENSE](./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](https://stayker.com/legal/mcp-policy/).

---

© 2026 WPF Holdings, LLC. All rights reserved.