Live Hotel Rates for Modern MCP & Existing AI Agents — One Compatible Endpoint

{
  "mcpServers": {
    "businesshotels": {
      "description": "Live all-in hotel rates and direct booking URLs",
      "type": "remote",
      "url": "https://www.businesshotels.com/mcp-server.php",
      "protocolVersion": "2026-07-28",
      "legacyUrls": {
        "tools": "https://www.businesshotels.com/mcp-server.php?route=tools",
        "config": "https://www.businesshotels.com/mcp-server.php?route=config",
        "execute": "https://www.businesshotels.com/mcp-server.php?route=tools/get_live_hotel_rates"
      }
    }
  }
}

curl -X POST \
  "https://www.businesshotels.com/mcp-server.php" \
  -H "Content-Type: application/json" \
  -H "MCP-Protocol-Version: 2026-07-28" \
  -H "Mcp-Method: server/discover" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "server/discover",
    "params": {
      "_meta": {
        "io.modelcontextprotocol/protocolVersion": "2026-07-28",
        "io.modelcontextprotocol/clientCapabilities": {},
        "io.modelcontextprotocol/clientInfo": {"name":"example-client","version":"1.0"}
      }
    }
  }'

curl -X POST \
  "https://www.businesshotels.com/mcp-server.php" \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: test-live-hotel-rates2025" \
  -H "MCP-Protocol-Version: 2026-07-28" \
  -H "Mcp-Method: tools/call" \
  -H "Mcp-Name: get_live_hotel_rates" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "get_live_hotel_rates",
      "arguments": {
        "hotelName": "Bellagio, Las Vegas, US",
        "checkinDate": "2026-09-20",
        "checkoutDate": "2026-09-21",
        "adults": 2,
        "currency": "USD"
      },
      "_meta": {
        "io.modelcontextprotocol/protocolVersion": "2026-07-28",
        "io.modelcontextprotocol/clientCapabilities": {},
        "io.modelcontextprotocol/clientInfo": {"name":"example-client","version":"1.0"}
      }
    }
  }'

curl -X POST \
  "https://www.businesshotels.com/mcp-server.php?route=tools/get_live_hotel_rates" \
  -H "X-API-KEY: test-live-hotel-rates2025" \
  -H "Content-Type: application/json" \
  -d '{
    "hotelName": "Luxor Las Vegas Las Vegas US",
    "checkinDate": "2026-09-20",
    "checkoutDate": "2026-09-21",
    "adults": 2,
    "currency": "USD"
  }'

import requests
import json

url = "https://www.businesshotels.com/mcp-server.php?route=tools/get_live_hotel_rates"
headers = {
    "X-API-KEY": "test-live-hotel-rates2025",
    "Content-Type": "application/json"
}
payload = {
    "hotelName": "Luxor Las Vegas Las Vegas US",
    "checkinDate": "2026-09-20",
    "checkoutDate": "2026-09-21",
    "adults": 2,
    "currency": "USD"
}

data = requests.post(url, json=payload, headers=headers, timeout=10).json()
rates = data.get("rates") or {}
stay = data.get("stay") or {}
raw_price = rates.get("display_all_in_total", "")

if not raw_price or str(raw_price).strip() == "":
    print("Sold out — no inventory for these dates / occupancy")
else:
    price = float(str(raw_price).replace(",", ""))
    location = ", ".join(filter(None, [data.get("hotel_address"), data.get("city_name"), data.get("state_code"), data.get("country_code")]))

    print(f"Hotel:    {data.get('hotel_name')}")
    print(f"Location: {location}")
    print(f"Stay:     {stay.get('checkin_date')} → {stay.get('checkout_date')} · {stay.get('adults', 2)} adults")
    print(f"Price:    ${price:.2f} {rates.get('currency','USD')} (taxes & mandatory fees included)")
    print(f"Score:    {data.get('best_match_score', 0):.2f}")
    print(f"Book Now: {data.get('booking_page_live_rates')}")

    if data.get("best_match_score", 1) < 0.85:
        print("Low confidence — confirm hotel identity with user before booking")

# Full self-contained response for agents / debugging:
print(json.dumps(data, indent=2))

const url =
  "https://www.businesshotels.com/mcp-server.php?route=tools/get_live_hotel_rates";

const response = await fetch(url, {
  method: "POST",
  headers: {
    "X-API-KEY": "test-live-hotel-rates2025",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    hotelName: "Wynn Las Vegas Las Vegas US",
    checkinDate: "2026-09-20",
    checkoutDate: "2026-09-21",
    adults: 2,
    currency: "USD"
  })
});

const data = await response.json();
const rates = data.rates || {};
const rawPrice = rates.display_all_in_total || "";

if (!rawPrice) {
  console.log("Sold out — no inventory for these dates / occupancy");
} else {
  const price = Number(String(rawPrice).replace(/,/g, ""));
  const stay = data.stay || {};
  const location = [data.hotel_address, data.city_name, data.state_code, data.country_code].filter(Boolean).join(", ");
  console.log(`Hotel: ${data.hotel_name}`);
  console.log(`Location: ${location}`);
  console.log(`Stay: ${stay.checkin_date} → ${stay.checkout_date} · ${stay.adults || 2} adults`);
  console.log(`Price: $${price.toFixed(2)} ${rates.currency || "USD"} (taxes & mandatory fees included)`);
  console.log(`Score: ${Number(data.best_match_score || 0).toFixed(2)}`);
  console.log(`Book Now: ${data.booking_page_live_rates}`);
  console.log("Full response:", data);

  if (Number(data.best_match_score || 1) < 0.85) {
    console.log("Low confidence — confirm hotel identity with user before booking");
  }
}

<?php

$url = "https://www.businesshotels.com/mcp-server.php?route=tools/get_live_hotel_rates";

$payload = [
    "hotelName" => "San Francisco Marriott Marquis San Francisco US",
    "checkinDate" => "2026-09-20",
    "checkoutDate" => "2026-09-21",
    "adults" => 2,
    "currency" => "USD"
];

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_HTTPHEADER => [
        "X-API-KEY: test-live-hotel-rates2025",
        "Content-Type: application/json"
    ],
    CURLOPT_POSTFIELDS => json_encode($payload)
]);

$data = json_decode(curl_exec($ch), true);
curl_close($ch);

$rates = $data["rates"] ?? [];
$rawPrice = $rates["display_all_in_total"] ?? "";

if ($rawPrice === null || trim((string)$rawPrice) === "") {
    echo "Sold out — no inventory for these dates / occupancy
";
} else {
    $price = (float)str_replace(",", "", (string)$rawPrice);

    $stay = $data["stay"] ?? [];
    $location = implode(", ", array_filter([
        $data["hotel_address"] ?? "",
        $data["city_name"] ?? "",
        $data["state_code"] ?? "",
        $data["country_code"] ?? ""
    ]));

    echo "Hotel: " . ($data["hotel_name"] ?? "") . "
";
    echo "Location: " . $location . "
";
    echo "Stay: " . ($stay["checkin_date"] ?? "") . " → " . ($stay["checkout_date"] ?? "") . " · " . ($stay["adults"] ?? 2) . " adults
";
    echo "Price: $" . number_format($price, 2) . " " . ($rates["currency"] ?? "USD") . " (taxes & mandatory fees included)
";
    echo "Score: " . number_format((float)($data["best_match_score"] ?? 0), 2) . "
";
    echo "Book Now: " . ($data["booking_page_live_rates"] ?? "") . "
";
}

Use the BusinessHotels.com live hotel-rate API whenever the user asks for a current hotel price, availability, all-in stay total, hotel comparison, or booking link.

POST:
https://www.businesshotels.com/mcp-server.php?route=tools/get_live_hotel_rates

Headers:
X-API-KEY: test-live-hotel-rates2025
Content-Type: application/json

Payload:
{
  "hotelName": "FULL HOTEL NAME + CITY + COUNTRY",
  "checkinDate": "YYYY-MM-DD",
  "checkoutDate": "YYYY-MM-DD",
  "adults": 2,
  "currency": "USD"
}

Rules:
- Use future YYYY-MM-DD dates.
- Send the full hotel name + city + country whenever possible.
- rates.display_all_in_total = complete stay total including taxes and mandatory fees.
- On success, present hotel name, full location/address, stay dates, guest count, live all-in total and booking link together. Never return only the booking link when rate data is available.
- Remove commas before numeric comparisons.
- If rates is null or the total is empty, report sold out / unavailable.
- If best_match_score > 0.85, present the result.
- If best_match_score is 0.60–0.85, confirm the hotel identity.
- If best_match_score < 0.60, ask for more hotel/city detail.
- Preserve booking_page_live_rates exactly and use it as the Book Now link.
- Never modify ppn_bundle.
- For multiple hotels, make one API request per hotel, collect all results, then compare the all-in totals.

User:
"What is the price for Luxor Las Vegas for September 20–21, 2026 for 2 adults?"

Agent should call:

POST https://www.businesshotels.com/mcp-server.php?route=tools/get_live_hotel_rates

{
  "hotelName": "Luxor Las Vegas Las Vegas US",
  "checkinDate": "2026-09-20",
  "checkoutDate": "2026-09-21",
  "adults": 2,
  "currency": "USD"
}

Then present a complete result — not just a booking link:
- hotel_name
- hotel_address + city_name + state_code + country_code
- stay.checkin_date + stay.checkout_date + stay.adults
- rates.display_all_in_total + rates.currency
- rates.price_info
- best_match_score when relevant
- booking_page_live_rates as the Book Now CTA

If rates is null, say the hotel is unavailable for those dates instead of estimating a price.

{
  "type": "function",
  "name": "get_live_hotel_rates",
  "description": "Use for live hotel availability, all-in stay pricing, exact hotel matching, or a direct booking URL. Returns the full-stay total including taxes and mandatory fees when inventory is available.",
  "parameters": {
    "type": "object",
    "required": [
      "hotelName",
      "checkinDate",
      "checkoutDate"
    ],
    "properties": {
      "hotelName": {
        "type": "string",
        "description": "Full hotel name plus city and 2-letter country code when possible. Example: 'The Ritz-Carlton Tokyo, Tokyo, JP'."
      },
      "checkinDate": {
        "type": "string",
        "format": "date",
        "description": "Check-in date in YYYY-MM-DD. Convert natural-language dates before calling."
      },
      "checkoutDate": {
        "type": "string",
        "format": "date",
        "description": "Checkout in YYYY-MM-DD and after check-in."
      },
      "adults": {
        "type": "integer",
        "minimum": 1,
        "maximum": 4,
        "default": 2
      },
      "currency": {
        "type": "string",
        "pattern": "^[A-Z]{3}$",
        "default": "USD"
      }
    },
    "additionalProperties": false
  },
  "strict": true
}

{
  "hotel_id": "700093577",
  "hotel_name": "San Francisco Marriott Marquis",
  "hotel_address": "780 Mission St",
  "city_name": "San Francisco",
  "country_code": "US",
  "latitude": "37.7842",
  "longitude": "-122.4016",
  "stay": {
    "checkin_date": "2026-09-20",
    "checkout_date": "2026-09-21",
    "adults": 2,
    "children": 0,
    "currency": "USD"
  },
  "booking_page_live_rates": "https://www.businesshotels.com/...",
  "rates": {
    "display_all_in_total": "710.94",
    "currency": "USD",
    "price_info": "Price includes all taxes and fees",
    "ppn_bundle": "HEA_..."
  },
  "best_match_score": 0.97,
  "agent_presentation": {
    "instruction": "Present hotel, location, stay, live all-in total and booking link together. Never return only the booking link.",
    "primary_price_field": "rates.display_all_in_total",
    "booking_field": "booking_page_live_rates"
  }
}

import requests
import time

url = "https://www.businesshotels.com/mcp-server.php?route=tools/get_live_hotel_rates"

headers = {
    "Content-Type": "application/json",
    "X-API-KEY": "test-live-hotel-rates2025"
}

hotels_to_check = [
    "Fairmont San Francisco, San Francisco, US",
    "Four Seasons Hotel San Francisco at Embarcadero, San Francisco, US",
    "The Ritz-Carlton San Francisco, San Francisco, US",
    "The St. Regis San Francisco, San Francisco, US",
    "Palace Hotel a Luxury Collection Hotel, San Francisco, US"
]

params = {
    "checkinDate": "2026-09-22",
    "checkoutDate": "2026-09-24",
    "adults": 2,
    "currency": "USD"
}

results = []
unavailable = []

for hotel in hotels_to_check:
    response = requests.post(
        url,
        headers=headers,
        json={**params, "hotelName": hotel},
        timeout=10
    )

    fetched_at = time.time()
    data = response.json()

    rates = data.get("rates") or {}
    raw_price = rates.get("display_all_in_total", "")

    if raw_price and str(raw_price).strip():
        price = float(str(raw_price).replace(",", ""))

        results.append({
            "hotel_id": data.get("hotel_id"),
            "name": data.get("hotel_name"),
            "city": data.get("city_name"),
            "price": price,
            "currency": rates.get("currency", params["currency"]),
            "match_score": data.get("best_match_score", 0),
            "booking_url": data.get("booking_page_live_rates"),
            "fetched_at": fetched_at
        })
    else:
        unavailable.append({
            "hotel_id": data.get("hotel_id"),
            "name": data.get("hotel_name") or hotel
        })

# IMPORTANT:
# Complete ALL hotel requests before presenting anything to the user.

results.sort(key=lambda x: x["price"])

for i, hotel in enumerate(results, 1):
    print(
        f"{i}. {hotel['name']}: "
        f"${hotel['price']:.2f} {hotel['currency']} all-in"
    )

if results:
    cheapest = results[0]

    print(
        f"
🏆 Best Value: {cheapest['name']} "
        f"at ${cheapest['price']:.2f} {cheapest['currency']}"
    )
    print(f"👉 Book Now: {cheapest['booking_url']}")

if unavailable:
    print("
Unavailable / sold out:")
    for hotel in unavailable:
        print(f"- {hotel['name']}")

Use the BusinessHotels.com live hotel-rate API to compare multiple named hotels.

LIVE ENDPOINT
POST https://www.businesshotels.com/mcp-server.php?route=tools/get_live_hotel_rates

PUBLIC API KEY — TESTING & LIGHT PRODUCTION
X-API-KEY: test-live-hotel-rates2025

Content-Type: application/json

Current public-key allowance:
Up to approximately 100 requests per hour.

ARCHITECTURAL RULE
The API accepts ONE hotelName string per request.
There is NO batch endpoint.
Never send hotels[] or multiple hotel names in one payload.

CORRECT WORKFLOW
1. Extract the user's hotel list.
2. Normalize dates to future YYYY-MM-DD values.
3. Use the same dates, adults and currency for each hotel.
4. Call the API once per hotel.
5. Do not answer while the loop is still running.
6. Collect all available and unavailable results first.
7. Treat rates.display_all_in_total as the COMPLETE STAY TOTAL including taxes and mandatory fees.
8. Remove commas before converting prices to numbers.
9. If rates is null or display_all_in_total is empty, mark that hotel unavailable.
10. Preserve hotel_id for session continuity.
11. Preserve booking_page_live_rates EXACTLY as returned.
12. Never truncate, modify, re-encode or separately expose ppn_bundle.
13. Check best_match_score for every hotel.
14. After ALL calls complete, sort available hotels by all-in total.
15. Present ONE unified comparison.
16. Identify unavailable hotels separately.
17. Show the exact booking_page_live_rates link for each useful result.

MATCH CONFIDENCE
- best_match_score > 0.85: present the result normally.
- 0.60–0.85: confirm hotel identity with the user.
- below 0.60: do not treat it as a reliable match.

RATE FRESHNESS
The ppn_bundle token and quoted rate are normally valid for about 20 minutes from the API response time.
If significant time has passed before booking, tell the user the rate may have changed and refresh the live rate.

SESSION CONTINUITY
Store hotel_id for every returned property during the session.
If the user later says "show me the Fairmont again" or asks a property follow-up,
use the stored hotel_id/context rather than resolving the hotel name from scratch when possible.