# Mews MCP

> Mews MCP gives your hotel staff conversational access to every core operation—reservations, billing, room status, and guest profiles. Instead of clicking through multiple dashboards, your agent handles complex tasks like checking today's check-ins, verifying a guest's full financial history, or getting real-time housekeeping updates just by talking to it.

## Overview
- **Category:** erp-operations
- **Price:** Free
- **Tags:** property-management, reservations, hotel-management, guest-experience, cloud-pms

## Description

Connecting Mews to any AI client turns your front desk into an intelligent concierge. You stop navigating separate modules for bookings, payments, and room status. Your agent handles the complexity of hotel operations through natural conversation, giving you immediate answers about everything from today's expected arrivals to a guest’s full billing history. Whether you manage rooms, handle check-ins, or crunch revenue numbers, all operational data is centralized. This MCP means your AI client can pull together information—like combining a reservation with the room's current status and the guest's loyalty tier—and present it as one coherent answer. You connect this Mews MCP through Vinkius, giving your agent access to thousands of industry tools so you never have to switch contexts again.

## Tools

### get_reservations
Retrieves hotel booking information for a specific date range, detailing who is arriving and staying.

### list_bills
Shows the complete financial history of a guest by listing all incurred charges and services.

### list_payments
Retrieves records of payments, including amounts, dates, and whether they have been settled.

### get_property_info
Pulls core operational settings and configuration data for the entire hotel property.

### get_reservation
Fetches full details for a single, specified reservation using its unique ID or booking reference.

### search_guests
Finds a guest's comprehensive profile, including contact information, loyalty status, and past stay records.

### get_guest
Retrieves the complete profile data for one specific hotel guest.

### list_rooms
Lists all rooms in the property and their current status, helping staff know what's vacant or occupied.

### list_room_blocks
Checks for large blocks of rooms that are reserved for groups over a specific date range.

### list_rates
Displays available room rate plans, including pricing and rules on when those rates apply.

### list_services
Lists all extra hotel services offered to guests, such as spa treatments or airport transfers.

### list_outlet_items
Provides a list of items sold through point-of-sale outlets, along with their pricing and categories.

## Prompt Examples

**Prompt:** 
```
Who is checking in today and are there any VIP guests?
```

**Response:** 
```
🏨 **Today's Check-ins — Oct 18**

📊 **12 arrivals** | 3 VIP | 2 groups

**VIP Arrivals** ⭐
- **Sir James & Lady Henderson** — Presidential Suite 801
  💎 Platinum loyalty | 14 past stays | $127,000 LTV
  🍾 Pre-arrival: champagne, flowers, late check-out

- **Dr. Sarah Chen** — Deluxe King 412
  💎 Gold loyalty | Business travel
  🚗 Airport transfer confirmed 14:30

**Group: Acme Corp Retreat** (8 rooms)
- Arriving 15:00-17:00 | Conference Room B reserved
- Contact: Maria Lopez, VP Operations
```

**Prompt:** 
```
Show me the housekeeping status for the 3rd floor.
```

**Response:** 
```
On the 3rd floor: 12 rooms are Clean and Inspected, 5 rooms are Dirty (currently occupied), and Room 304 is Out of Order due to a plumbing issue. Housekeeping should prioritize Room 310 which has a VIP arrival at 2:00 PM.
```

**Prompt:** 
```
What is our average daily rate (ADR) for this weekend?
```

**Response:** 
```
The projected Average Daily Rate (ADR) for this upcoming Friday to Sunday is $245. This is driven by high demand and strong performance in our premium suite categories.
```

## Capabilities

### Check daily arrivals
Retrieve comprehensive details on all guests checking in or out within a specified date range.

### Search detailed guest profiles
Pull up full customer records, including contact info, loyalty status, past stays, and any noted preferences or allergies.

### Review financial transactions
Generate a complete picture of a guest's finances by listing all charges, payments made, and outstanding balances.

### Get real-time room status reports
List the current status of every hotel room, noting if it is clean, occupied, or out of order.

### Analyze rate availability and pricing
Check available room types and their associated rates while considering specific booking rules and restrictions.

## Use Cases

### Handling an unexpected group inquiry
A sales team needs to know if they can book 20 rooms next quarter. They ask their agent, which calls list_room_blocks and list_rates. The agent instantly verifies availability for the specific dates while also checking pricing restrictions.

### Preparing a VIP guest check-in
The front desk agent needs to know everything about a high-tier guest arriving today. They use search_guests and get_guest, which pulls up loyalty details and past preferences, allowing the agent to flag special touches needed before arrival.

### Solving a billing dispute
A guest claims they were overcharged for a dinner service. The agent runs list_bills and checks it against list_payments, immediately pinpointing the charge date and comparing it to settled payments so staff can correct the ledger.

### Morning operations briefing
The general manager asks, 'Who are our VIP arrivals today?' The agent uses get_reservations and gets_reservation, summarizing all key details—including room type and group affiliation—in one report.

## Benefits

- Never guess a guest's status again. Your agent uses search_guests to instantly pull up their profile—including loyalty tier, allergies, and past stay history—so you can personalize service immediately.
- Cut down on billing disputes. Instead of opening multiple tabs, your agent runs list_bills and list_payments to give a full financial ledger for any guest in seconds.
- Stay ahead of housekeeping emergencies. By calling list_rooms, you get a real-time status dashboard that shows which rooms are clean, dirty, or out of order across the whole property.
- Improve revenue decisions on the fly. You can cross-reference rate plans using list_rates and check group bookings with list_room_blocks to advise managers on optimal pricing strategies.
- Process complex check-ins effortlessly. By combining get_reservations, search_guests, and get_guest tools, your agent provides a single morning briefing that covers arrivals, VIP status, and room assignments.

## How It Works

The bottom line is that your AI client handles all the back-end API calls so you just get an instant conversation reply instead of opening 10 different tabs.

1. You ask your agent a natural language question, like 'What's the status of rooms on the third floor?'
2. The MCP intercepts that request, identifies the specific data needed (like room listing or housekeeping status), and runs the necessary tool calls against Mews.
3. Your agent receives structured, up-to-date data from Mews and formats it into a plain English answer for you.

## Frequently Asked Questions

**How does the Mews MCP help with check-ins?**
The Mews MCP helps by combining get_reservations and search_guests to give you a comprehensive morning briefing. You can instantly see who is arriving, their loyalty status, and what special notes are attached to their profile.

**Can I use the Mews MCP to find out room availability?**
Yes, you can use list_rooms to check real-time occupancy. You can also run list_room_blocks if you need to know about large group reservations coming up.

**What information does the get_guest tool provide?**
The get_guest tool pulls all known data on a guest, including their contact info, loyalty tier, past stays, and any noted preferences or allergies for staff to be aware of.

**Is the Mews MCP better than just using the native dashboard?**
The benefit is context. The native dashboard shows you data; this MCP uses your agent to interpret that data and deliver a synthesized answer, saving you clicks and time.

**Can I use list_outlet_items with Mews?**
Yes. You can use list_outlet_items to get pricing and categories for items sold at the hotel's point-of-sale, helping staff process charges accurately.