Trip.com MCP Server
Trip.com Model Context Protocol

Get Trip.com hotel data by chatting with AI.

Paste one prompt into Claude Code, Cursor, or your agent and it installs itself. Your agent then pulls Trip.com data from plain-English prompts. Same API key, same billing as the REST API.

50 free requests on signup No credit card Any language, no code

Trusted by hospitality teams at

What you can ask

Ask in plain English.
Get real Trip.com answers.

Whatever you'd ask a junior analyst about a hotel, ask your agent. No syntax to learn.

>

Find Shanghai hotels for my stay and compare the source stay totals, including taxes when available.

>

What do guests say about Trip.com hotel 702258?

>

Summarize the most recent Trip.com reviews for hotel 702258 and flag anything negative.

>

Group the Trip.com reviews for hotel 702258 by travel type and room type.

>

Show which Trip.com reviews for hotel 702258 got a reply from the property.

Behind the scenes

You type plain English. Your agent calls the right Trip.com tool.

Real examples. You ask, the agent picks a tool and fills the parameters, you read the answer. These outputs are illustrative.

01 Reviews
You ask

What do guests say about Trip.com hotel 702258?

Behind the scenes tripcom_hotel_reviews(hotel_id="702258", page=1, page_size=10)
You see

The most recent Trip.com reviews for that hotel with their ratings and stay dates, read back as a short summary instead of a raw list.

02 Segments
You ask

Group the Trip.com reviews for hotel 702258 by travel type and room type.

Behind the scenes tripcom_hotel_reviews(hotel_id="702258", page_size=20)
You see

The same reviews split by the travel type each guest picked and the room they booked, so a pattern in one segment stands out.

03 Replies
You ask

Show which Trip.com reviews for hotel 702258 got a reply from the property.

Behind the scenes tripcom_hotel_reviews(hotel_id="702258", page=1)
You see

The reviews that carry an owner response, paired with the reply and its date, so anything still unanswered is easy to spot.

Connect it

Paste one sentence. Your agent does the rest.

Copy the prompt into the agent you already have open. It reads our setup page and wires up the connector itself.

Paste into Claude Code
Read https://stayapi.com/install and set up the StayAPI MCP server for me.

Then open a new session and run claude mcp list — stayapi should read ✓ Connected.

No key yet? Sign up for 50 free requests — the agent asks you for it.

Claude on the web, desktop, or mobile doesn't need this prompt: add StayAPI under Settings → Connectors and sign in. ChatGPT: add it as an MCP app in developer mode and sign in. Other clients: manual setup below.

No key

Claude on the web, desktop & mobile

Add StayAPI as a connector and sign in. Nothing to paste.

  1. In Claude, open Settings → Connectors → Add custom connector.
  2. Name it StayAPI and set the URL to https://api.stayapi.com/mcp.
  3. Click Connect, sign in to StayAPI, and choose Allow.
No key

ChatGPT (developer mode)

Add StayAPI as an MCP app and sign in. Plus, Pro, Business, Enterprise, or Edu, on the web.

  1. In ChatGPT, turn on Settings → Security and login → Developer mode.
  2. Open chatgpt.com/plugins, click +, and choose Create MCP app.
  3. Name it StayAPI, set the URL to https://api.stayapi.com/mcp, and pick OAuth. Leave the client ID and secret blank.
  4. Sign in to StayAPI, choose Allow, then install StayAPI from your personal plugins.
  5. In a Work chat, type @StayAPI and ask.
Manual setup — paste the config yourself
01

Claude Code

One terminal command.

bash
claude mcp add --scope user --transport http stayapi https://api.stayapi.com/mcp --header "X-API-Key: YOUR_API_KEY"
  1. Run the command in any terminal.
  2. Open a new Claude Code session.
  3. Confirm with claude mcp list.
02

Cursor

Edit ~/.cursor/mcp.json.

json
{
  "mcpServers": {
    "stayapi": {
      "type": "http",
      "url": "https://api.stayapi.com/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}
  1. Open or create the file.
  2. Paste, swap YOUR_API_KEY, save.
  3. Restart Cursor.
03

Claude Desktop

Edit claude_desktop_config.json.

json
{
  "mcpServers": {
    "stayapi": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote@0.1.18",
        "https://api.stayapi.com/mcp",
        "--header", "X-API-Key:YOUR_API_KEY"
      ]
    }
  }
}
  1. Open the config file in your OS.
  2. Paste, swap the key, save.
  3. Quit Claude with ⌘ Q, relaunch.

On Windows, a bare npx can fail with spawn npx ENOENT. Use the absolute path to npx.cmd. Windows setup notes →

Full reference — every tool, error shapes, Windows notes: MCP documentation →

Tools for Trip.com

The Trip.com tools your agent can call.

Most agents pick the right tool from your prompt, so you never name it. One tool call counts as one request, the same as a REST request.

tripcom_search_hotels

Search by Trip.com city_id and required check_in/check_out. Optional hotel_name requests native name matching within the required city/stay (trimmed 1–200 characters; no controls); response hotel_name is a nullable normalized keyword. First page only, limit 1–20 (default 10). Advertised price basis and tax inclusion are unspecified; quoted payment totals can exclude charges due at the property. Retain labels and notes; search does not guarantee bookability. Selected-room metadata and source labels describe one offer, not full inventory or capacity.

tripcom_hotel_reviews

Get paginated reviews served by Trip.com, with per-review source: tripcom, ctrip, expedia, hotelscom, tripadvisor, or unknown. Includes ratings, text, stay dates and owner responses. Aggregate Expedia counts do not identify review origin; token and signature fields are excluded. total_reviews is the hotel aggregate; pageable_reviews is the current feed count, not a promise that all aggregate rows are retrievable. page_size is 1 to 50, default 10.

Full parameters and response shapes live in the MCP docs. For the same data over REST, see the Trip.com API hub.

Point your agent at Trip.com.

Sign up, paste one prompt, let your agent install itself. Both paths end with your agent answering Trip.com questions in plain English.

01 · the fast path

Get your key

50 free requests on signup. Paste one prompt into your agent, then start asking it for Trip.com data.

Start free Read the MCP docs
  • 50 free requests, no credit card
  • Same key as the REST API
  • Any language, no code
02 · talk to us

Talk through your use case

15 minutes. We screen-share and wire Claude or Cursor to your real properties. Free of charge.

Book a demo
  • Working setup on the call
  • Your properties, your prompts
  • Engineering, not sales