Best We Hotel MCP Server
Best We Hotel Model Context Protocol

Get Best We Hotel hotel data by chatting with AI.

Paste one snippet into Claude, Cursor, or Claude Code. Your agent pulls Best We Hotel 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 Best We Hotel answers.

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

>

Search Best We hotels in Shanghai for my dates and show the lowest visible CNY prices.

>

Turn this Best We hotel URL into a property ID and get the hotel details.

>

Summarize recent Best We reviews for Jin Jiang Tower Shanghai and flag recurring complaints.

>

Show Best We room inventory and separate public rates from member rates for my stay.

>

Pull the Best We photo reviews for property JJ1089 and include hotel responses.

Behind the scenes

You type plain English. Your agent calls the right Best We Hotel 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

Summarize recent Best We reviews for Jin Jiang Tower Shanghai and flag recurring complaints.

Behind the scenes bestwe_hotel_reviews(property_id="JJ1089", page=1, page_size=20)
You see

The latest guest comments grouped into recurring praise and complaints, with score dimensions and any hotel replies kept alongside the source review.

02 Rooms
You ask

Show Best We room inventory and separate public rates from member rates for my stay.

Behind the scenes bestwe_hotel_rooms(property_id="JJ1089", check_in="2026-08-10", check_out="2026-08-11")
You see

The available room types for those dates with CNY prices, breakfast, cancellation rules, and member-rate flags separated for comparison.

03 URL to ID
You ask

Turn this Best We hotel URL into a property ID and get the hotel details.

Behind the scenes bestwe_hotel_url_to_id(url="https://hotel.bestwehotel.com/HotelDetail?hotelId=JJ1089") -> bestwe_hotel_details(property_id=...)
You see

The stable property ID resolved locally, followed by the bilingual hotel content, facilities, photos, policies, and room catalogue.

Connect it

Pick your client. Paste one block.

Three config systems, three snippets. Swap YOUR_API_KEY for your real key and start asking.

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 →

Shortcut Don't have a key yet? Sign up for 50 free requests. Your dashboard ships these snippets pre-filled.

Tools for Best We Hotel

The Best We Hotel 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.

bestwe_search_hotels

Search dated Best We Hotel inventory by Best We city code. Returns property IDs, public metadata, availability, and lowest visible CNY prices.

bestwe_hotel_url_to_id

Extract a Best We property_id locally from a canonical hotel.bestwehotel.com HotelDetail URL.

bestwe_hotel_details

Get bilingual Best We property content, policies, photos, facilities, services, and static room metadata.

bestwe_hotel_reviews

Get paginated Best We guest reviews with scores, moderated photos, tags, room context, and hotel replies.

bestwe_hotel_rooms

Get dated Best We room inventory and public or member rate plans with CNY prices, breakfast, and cancellation rules.

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

Point your agent at Best We Hotel.

Sign up, copy one snippet, drop your key in. Both paths end with your agent answering Best We Hotel questions in plain English.

01 · the fast path

Get your key

50 free requests on signup. Copy one snippet, drop your key in, and start asking your agent for Best We Hotel 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