4,500+ servers built on MCP Fusion
Vinkius

Mews MCP. Manage guest data, billing, and room status instantly.

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

Mews MCP on Cursor AI Code Editor MCP Client Mews MCP on Claude Desktop App MCP Integration Mews MCP on OpenAI Agents SDK MCP Compatible Mews MCP on Visual Studio Code MCP Extension Client Mews MCP on GitHub Copilot AI Agent MCP Integration Mews MCP on Google Gemini AI MCP Integration Mews MCP on Lovable AI Development MCP Client Mews MCP on Mistral AI Agents MCP Compatible Mews MCP on Amazon AWS Bedrock MCP Support

Just plug in your AI agents and start using Vinkius.

Mews MCP Server connects your AI client directly to core hotel operations data. It lets you manage reservations, guest profiles, room status, billing records, and services using natural conversation.

Instead of navigating separate dashboards for check-ins, financials, or housekeeping reports, your agent pulls all the necessary Mews data in one request.

This means instant operational insight, whether you're checking a VIP's history or calculating daily revenue.

What your AI agents can do

Get guest

Retrieves a single guest's profile using their ID.

Get property info

Gets the main configuration details for the entire hotel property setup.

Get reservation

Retrieves specific booking details for a single reservation ID.

+ 9 more capabilities included
Pull Guest History

Find and summarize a guest's full profile, including contact info, loyalty tiers, and past stay records.

Check Arrival Status

Retrieve lists of hotel reservations, filtering by date range to quickly identify check-ins, departures, or room assignments.

Audit Guest Billing

List a guest's complete financial history, tracking all charges from the bill (list_bills), payments, and point of sale (POS) items.

View Room Availability

Get real-time lists of rooms, their status, and applicable rate plans for specific dates.

List Services & Pricing

Pull the entire catalog of bookable hotel services (like spa treatments or laundry) along with their pricing details.

Supported MCP Clients

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
+ other MCP clients
Free for Subscribers

Waiting for input…

AI Agent

Mews MCP Server: 12 Tools for Property Management

This set of tools gives your AI client direct access to Mews PMS functions, allowing it to manage everything from guest profiles and bookings to financial records.

get019d75d4

get guest

Retrieves a single guest's profile using their ID.

get019d75d4

get property info

Gets the main configuration details for the entire hotel property setup.

get019d75d4

get reservation

Retrieves specific booking details for a single reservation ID.

get019d75d4

get reservations

Finds and lists multiple reservations, perfect for checking in groups or calculating daily arrivals.

list019d75d4

list bills

Generates a complete financial history for a guest, detailing all charges and services rendered.

list019d75d4

list outlet items

Lists every item the hotel can sell at the POS, including pricing and categories.

list019d75d4

list payments

Provides a list of all payments made against an account, detailing amounts, dates, and settlement status.

list019d75d4

list rates

Lists all available room rate plans, including pricing tiers and booking restrictions.

list019d75d4

list room blocks

Shows groups of reserved rooms, detailing the dates they are blocked out until release.

list019d75d4

list rooms

Provides a comprehensive list of all physical hotel rooms and their current status.

list019d75d4

list services

Retrieves the catalog of all bookable services offered by the property (e.g., spa, laundry).

search019d75d4

search guests

Searches for a guest across the entire database, returning profile details, contact info, and billing history.

Choose How to Get Started

Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.

Build Your Own

Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.

  • Import from OpenAPI, Swagger, or YAML specs
  • Create Agent Skills with progressive disclosure
  • Deploy to edge with MCPFusion framework
  • Built in DLP, auth, and compliance on every call
  • Real time usage dashboard and cost metering
  • Publish to catalog or keep private
Start building

Make Your AI Do More

Start with Mews, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.

  • Use this MCP plus 4,700+ others, all in one place
  • Add new capabilities to your AI anytime you want
  • Every connection is secured and compliant automatically
  • Track usage and costs across all your servers
  • Works with Claude, ChatGPT, Cursor, and more
  • New servers added to the catalog every week

What you can do with this MCP connector

This MCP Server hooks your AI client up straight to Mews core operations data. You'll stop running around clicking through different dashboards for check-ins, billing, or housekeeping reports. Instead, your agent pulls all the necessary Mews info in one shot—a single conversation gets you instant operational insight.

Finding Guests and History
When you need to know who a guest is, your agent uses search_guests to look across the whole database. It returns profile details, contact info, and even their billing history all in one go. If you have an ID, get_guest pulls that single person's complete file. You can pull together a guest’s full profile, including loyalty status, preferences, and past stay records.

Managing Stays and Availability
Need to check arrivals? Use get_reservations to list multiple bookings; you can filter this down by date range to quickly identify who's checking in or leaving. If you need details on one specific booking, the agent uses get_reservation. To see what rooms are open—or blocked off for a group event—you use list_rooms which gives real-time status for every physical hotel room.

You can also check out list_room_blocks, which shows groups of reserved rooms and exactly when those blocks expire.

Handling the Money (Billing & Payments)
This is where you audit everything. To see a guest's full financial picture, the agent uses list_bills. This gives a complete history, tracking every charge and service rendered against their account folio. For payments, list_payments provides a list of all money deposited, showing amounts, dates, and whether they settled correctly.

You can also pull details on what items the hotel sells at the register using list_outlet_items, including pricing and categories. To check out room rates or package deals, you run list_rates to see every available rate plan and any booking restrictions associated with it.

Cataloging Services
When a guest uses the spa or laundromat, you need to know what's bookable. list_services retrieves the entire catalog of services offered by the property—like treatments or laundry loads—along with their pricing details. You can also pull all the main configuration data for the hotel setup itself using get_property_info, which gives you general operational details about the property.

By connecting these tools, your agent acts like a front desk supervisor who never needs to switch screens. For instance, you can ask: "Show me today's arrivals, list their full billing history, and pull up all available spa services." You get one coherent response that pulls guest contact info (search_guests), booking lists (get_reservations), financial records (list_bills, list_payments), and service catalogs (list_services) without you having to run five separate reports.

How Mews MCP Works

  1. 1 Your AI client sends a complex request to the Mews MCP Server, for instance: "Show me all arrivals today and list any outstanding charges on their account."
  2. 2 The server's orchestration layer identifies that it needs multiple tools—get_reservations (for arrivals) and list_bills (for charges)—and runs them in sequence or parallel.
  3. 3 The server aggregates the structured data from both APIs, formats it into a single clean response object, and sends it back to your AI client for final presentation.

The bottom line is that you don't write complex multi-step code; you just ask the AI what you need, and the server runs all the necessary API calls behind the scenes.

Who Is Mews MCP For?

This tool is for operations managers and high-volume front desk staff who are tired of clicking through five different screens just to complete a single task. If you spend time cross-referencing room availability with billing records, this saves hours.

Front Desk Agent

You use it to run instant morning briefings: "Who's checking in today? Are there any VIP arrivals, and what are their preferences?"

Revenue Manager

You check rate plan performance across multiple dates by combining list_rates with booking data to analyze revenue streams.

General Manager

You run daily operational audits, checking overall KPIs like occupancy and service usage without logging into the main dashboard.

What Changes When You Connect

  • Instant Guest Context: Instead of manually checking multiple tabs for a VIP's history, search_guests pulls their profile, loyalty tier, past stays, and preferences into one view. You know everything you need to know about them immediately.
  • Full Billing Visibility: Don't guess what the guest owes. By combining list_bills, list_payments, and list_outlet_items, your agent can build a real-time financial audit trail for any folio.
  • Operational Awareness: Need to know if Room 304 is clean? Use list_rooms to get the current status (clean/dirty) right alongside checking occupancy using get_reservations. It ties room inventory directly to bookings.
  • Revenue Analysis on Demand: Calculating Average Daily Rate (ADR) used to be a dashboard chore. Now, by running list_rates and cross-referencing it with booked rooms via get_reservations, your agent gets instant performance metrics.
  • Comprehensive Service Cataloging: When a guest asks for a service, you don't have to guess the price or availability. list_services provides the entire catalog and pricing structure instantly.

Real-World Use Cases

01

The Morning Check-In Briefing

A front desk agent needs to know who is arriving today and if any have special requests. They ask their agent: 'Who's checking in, and what are the VIP details?' The agent runs get_reservations followed by search_guests, pulling arrival lists and specific guest preferences (like late check-out or champagne) into one summary.

02

Investigating a Billing Dispute

A guest disputes a charge. Instead of hunting through receipts, the agent asks: 'Show me all charges for Mr. Smith.' The agent runs search_guests (to verify identity) and then executes list_bills, immediately showing every POS item (list_outlet_items) charged to their account.

03

Optimizing Room Allocation

The housekeeping manager needs to prioritize cleaning. They ask: 'What rooms are vacant, and which ones need service?' The agent runs list_rooms (getting status) and combines that with get_reservations (to see who is arriving next), giving the team an actionable priority list.

04

Checking Group Rates

A group booking needs a rate quote. The agent asks: 'What are our rates for 10 rooms next month?' The system runs list_rates and uses parameters to filter by availability rules, giving the sales team accurate pricing instantly.

The Tradeoffs

Treating data sources as separate searches

A user might try to first check room status using list_rooms, and then run a completely separate query for reservations using get_reservations. This requires two API calls and the human doing the merging of data.

Ask the agent one combined question: 'Show me all rooms that are occupied by guests arriving next week.' The server handles linking list_rooms status with future arrivals from get_reservations.

Assuming billing covers everything

A user might only check list_bills and miss ancillary charges. They see a total, but the details are missing.

Always request a full financial picture by listing payments (list_payments) alongside bills to verify that all transactions have been accounted for.

Relying on memory for IDs

A user might remember a guest name but not the ID, and try to query get_reservation directly. It will fail.

Always start by using search_guests. This tool finds the correct profile and provides the necessary unique identifiers needed for all subsequent calls like list_bills.

When It Fits, When It Doesn't

Use this server if your task requires synthesizing information across multiple operational domains. You need to know why a room is available (check list_rooms), who is booking it next week (get_reservations), and what rate applies (list_rates). This orchestration layer is built for complex queries that span billing, inventory, and guest profiles.

Don't use this if you just need one simple piece of data, like a single room number or a specific payment amount. For those basic reads, the dedicated tools are efficient enough. If your workflow requires fetching a list of available services and comparing it to existing charges on a folio, then this server is what you need.

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Mews. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

VINKIUS INFRASTRUCTURE

Cloud Hosted

Managed infra

V8 Isolated

Sandboxed per request

Zero-Trust Proxy

No stored credentials

DLP Enforced

Policy on every call

GDPR Compliant

EU data residency

Token Compression

~60% cost reduction

How we secure it →

Works with Claude, ChatGPT, Cursor, and more

The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.

This server provides 12 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.

Available Capabilities

get_guest get_property_info get_reservation get_reservations list_bills list_outlet_items list_payments list_rates list_room_blocks list_rooms list_services search_guests

Tracking down a guest's full story shouldn't feel like an audit.

Today, if you need the complete picture of a guest—their loyalty status, their past stays, and any special notes—you have to jump through hoops. You check the main profile screen for basic info, then click into 'Billing' to see charges, and maybe open another tab to view preferences or allergies.

With this MCP server, you tell your agent: "What do I need to know about Mr. Jones?" The AI client runs `search_guests` once. It pulls the profile data, cross-references the billing history using `list_bills`, and consolidates it all for you. You get the full narrative instantly.

Mews MCP Server: Full Guest Data Access

Before, tracking down a guest's financial status meant manually comparing the initial reservation rate against all subsequent charges and payments. It was slow, prone to human error, and required multiple clicks across different modules.

Now, you ask your agent for the full folio history. The server uses `list_bills` and `list_payments` together. It doesn't just give you a list; it gives you the validated financial story. That’s a difference.

Common Questions About Mews MCP

How do I check today's arrivals using get_reservations? +

You run get_reservations and specify today's date range in the parameters. This tool is designed to retrieve all bookings that start or end within your requested timeframe, giving you a quick list of who needs service.

Can I find out if a room is available using list_rooms? +

Yes, list_rooms provides the current status (vacant/occupied) for every physical room in the hotel. This is your best tool for checking immediate inventory.

What should I use to see a guest's charges? list_bills or search_guests? +

You must use list_bills. While search_guests gives you the contact info and profile, only list_bills provides the detailed financial records of services rendered and payments.

Does get_property_info tell me about rates? +

No. get_property_info only handles general hotel settings and department names. For specific pricing, you must use the dedicated tool, list_rates.

If I use `list_payments`, how can I check the settlement status of a guest's payment? +

The tool returns detailed transaction records including the amount, date, and specific settlement status. You get granular insight into whether payments cleared successfully or if they require manual follow-up.

What kind of deep profile data can I retrieve about a guest using `get_guest`? +

You pull the complete guest profile, including contact information, loyalty status, and records of all past stays. This lets your agent immediately know the guest's preferences or known allergies.

How do I use `list_room_blocks` to check future room inventory? +

This tool lists rooms that are reserved or unavailable on specific dates, detailing the type and exact release date. It’s key for seeing how much inventory is committed far out.

Does `list_rates` help me understand pricing restrictions? +

Yes, it gives you rate plans along with all their associated rules, including pricing tiers and mandatory availability requirements. You see exactly what can be booked under certain conditions.

What types of hotels use Mews? +

Mews serves 5,000+ properties in 85+ countries — from boutique hotels and hostels to luxury resorts and hotel groups. It's a cloud-native PMS designed for modern hospitality.

Is the Mews API suitable for large hotel groups? +

Yes, Mews provides a robust API that supports multi-property operations, making it ideal for hotel groups to manage central reservations, corporate billing, and group-wide reporting.

Can I check room housekeeping status in real-time? +

Yes, you can query Mews to get the real-time status of any room, including whether it is clean, dirty, inspected, or out of order, which helps prioritize housekeeping efforts.

More in this category

You might also like

Built & Managed by Vinkius 30s setup 12 tools

We've already built the connector for Mews. Just plug in your AI agents and start using Vinkius.

No hosting. No infrastructure. No complex setup.
All 12 tools are live and waiting. You're up and running in seconds.

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
+ other MCP clients

Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.

Zero hosting required Full MCP catalog included Enterprise-grade security Auto-updated by Vinkius

Built, hosted, and secured by Vinkius. You just connect and go.