# Siteminder MCP

> Siteminder lets your AI client manage hotel inventory and reservations by connecting directly to channels plus and direct booking APIs. Use this MCP to search properties, check real-time room rates, lock availability, and confirm or cancel bookings via natural language commands.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** hotel-management, booking-engine, inventory-sync, channel-manager, reservations, hospitality-tech

## Description

Managing hotel distribution used to mean jumping between five different dashboards just to verify a single rate change or property status. This MCP changes that. It connects your agent directly to the core Siteminder APIs, letting you handle complex booking tasks through conversation instead of manual clicking.

You can ask it to search properties around a specific latitude and longitude for next month's dates. Need pricing? Just tell it which property ID you're interested in; it retrieves current room types and rates instantly. It handles the entire reservation lifecycle, too: lock inventory when you find a good deal, confirm the booking with guest details, or cancel an old reservation if plans change. When you subscribe to this MCP through Vinkius, your AI client gets access to all these tools in one place. You manage everything from listing historical bookings to querying real-time availability using simple prompts.

## Tools

### cp_cancel_reservation
Cancels an existing hotel reservation based on its ID.

### cp_confirm_reservation
Finalizes a booking by requiring and submitting guest and payment details.

### cp_get_property
Retrieves specific details about a property using the Channels Plus API.

### cp_list_reservations
Gets a list of historical bookings associated with your account through the Channels Plus API.

### cp_lock_reservation
Places a temporary, limited-time hold on available room inventory.

### cp_modify_reservation
Changes details on an existing booking, such as dates or guest names.

### cp_search_properties
Searches for properties based on location coordinates, a specific radius, and desired date range.

### db_get_property
Retrieves property details specifically within your linked group using the Direct Booking API.

### db_get_quotes
Checks pricing and availability for a particular stay date range through direct booking methods.

### db_get_room_rates
Retrieves the current list of room rates for a property using the Direct Booking API.

### db_get_room_types
Gets all available physical room types associated with a specific property via the Direct Booking API.

### db_list_properties
Lists every property that belongs to your group through the Direct Booking API.

### smx_get_availability
Queries real-time inventory levels for a given date range via the SMX API.

### smx_get_rates
Checks pricing across multiple properties for a specified period using the SMX API.

### smx_list_hotels
Lists all connected hotels managed by your publisher via the SMX API.

### smx_list_publishers
Retrieves a list of connected PMS providers using the SMX API.

### smx_list_rate_plans
Lists all available rate plans for a hotel via the SMX API.

### smx_list_room_types
Provides a list of room types for a specific hotel using the SMX API.

## Prompt Examples

**Prompt:** 
```
Find hotels near lat 40.7128, long -74.0060 within a 5km radius for next weekend.
```

**Response:** 
```
I've searched the area. I found 3 properties available: 'Grand Plaza' (UUID: gp-123), 'Urban Stay' (UUID: us-456), and 'Boutique Inn' (UUID: bi-789). Would you like to see the room rates for any of these?
```

**Prompt:** 
```
Get the room types and rates for property UUID '123-abc-456'.
```

**Response:** 
```
For property '123-abc-456', I found: 'Deluxe King' at $250/night and 'Standard Twin' at $180/night. Both are available for your selected dates. Should I proceed to lock a reservation?
```

**Prompt:** 
```
Show me the history of bookings for my account.
```

**Response:** 
```
Retrieving your reservation history... You have 12 recent bookings. The latest is 'RES-99821' for 'John Doe' at 'Grand Plaza', confirmed on Oct 12th. Would you like details on a specific reference ID?
```

## Capabilities

### Search for Properties
Find available properties by entering a geographic location, radius, and date range.

### Check Room Rates and Types
Get current room availability, types, and pricing for specific hotels or properties.

### Manage Booking Status
Perform key actions on existing reservations, like locking inventory, confirming a booking, modifying details, or canceling the reservation entirely.

### Review Account History
Retrieve and list all historical bookings associated with your account for review.

## Use Cases

### Rescheduling a Client Trip
A travel agent needs to change a client's stay dates. Instead of calling the hotel and manually updating their internal system, they prompt their agent: 'Modify reservation RES-12345 for three extra nights.' The MCP uses `cp_modify_reservation` to handle the update instantly.

### Checking Competitor Pricing
A revenue manager needs to quickly verify if a competitor's rate matches their current offering. They ask the agent for room rates using `db_get_room_rates`, getting accurate, real-time pricing data without logging into a separate dashboard.

### Finding Group Blocks
An event planner needs to find suitable venues near a conference center. They prompt the agent with coordinates and a radius; the MCP uses `cp_search_properties` to list all viable options immediately.

### Audit Trail Review
A property manager needs to review bookings from last quarter for an audit. They ask the agent to retrieve historical data, triggering `cp_list_reservations` and providing a complete record set.

## Benefits

- Stop checking multiple dashboards. You can use `cp_search_properties` to find available hotels just by typing a location, radius, and date range.
- Get accurate pricing instantly. Instead of guessing rates, you ask the MCP for room types and rates using `db_get_room_rates`, connecting you directly to current market prices.
- Process bookings end-to-end. You can use `cp_lock_reservation` when you find a deal, then follow up with `cp_confirm_reservation` without ever leaving your chat window.
- Maintain perfect records. Need to know what was booked last month? Use `cp_list_reservations` to pull up historical booking data immediately for reference.
- Handle changes easily. Instead of calling a manager, you can use `cp_modify_reservation` or `cp_cancel_reservation` to update or void bookings directly through your agent.

## How It Works

The bottom line is that you talk to your agent, and it handles the complex data retrieval and booking actions behind the scenes using Siteminder's APIs.

1. Subscribe to this MCP and provide your Siteminder API ID, API Key, and SMX Token.
2. Your agent uses these credentials to access the full suite of booking tools.
3. You issue a natural language request (e.g., 'Find me rooms at Grand Plaza for October 12th'), and the MCP executes the necessary function calls.

## Frequently Asked Questions

**Can Siteminder MCP find properties by name only?**
No, while you can list properties using `db_list_properties`, the most accurate property search requires coordinates. Use `cp_search_properties` and input a latitude/longitude pair for reliable results.

**How do I check if a rate is available?**
You use the MCP to query rates by calling `db_get_room_rates`. This function verifies current pricing and availability for your specific dates, which is better than relying on cached data.

**What's the difference between locking and confirming a booking?**
Using `cp_lock_reservation` sets aside inventory for a limited time. You must follow up with `cp_confirm_reservation` (with payment details) to finalize the sale; otherwise, the hold expires.

**Can Siteminder MCP help me list past bookings?**
Yes. Use the tool `cp_list_reservations` and provide your account information. This pulls a comprehensive history of all reservations associated with your credentials.

**Is this good for checking general market rates?**
This MCP is best for transactional, direct booking data. For broad market intelligence, you may need to consult a dedicated analytics tool instead of relying solely on `smx_get_rates`.