Skip to main content
Glama
Sign In
Mews MCP

Mews MCP

by code-rabi
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

Mews MCP Server

A Model Context Protocol (MCP) server for the Mews hospitality platform API. This server provides comprehensive access to Mews operations through a standardized interface.

Overview

This MCP server provides comprehensive access to the Mews hospitality platform API, covering customer and company management, reservation operations, financial transactions, account management, configuration settings, and services inventory. It implements the core functionality needed for hospitality management through a standardized Model Context Protocol interface.

Disclaimer: This is an unofficial MCP server for the Mews API and is not affiliated with or officially supported by Mews Systems s.r.o.

Related MCP server: guesty-mcp-server

Quick Start

Using Smithery (Recommended)

The easiest way to use this MCP server is through Smithery, which provides hosted MCP servers:

  1. Go to the Mews MCP server on Smithery

  2. Click "Add Configuration" and provide your Mews credentials

  3. Copy the connection URL to your AI client

Demo Environment: You can test this MCP server using Mews' public demo environment. The demo credentials are already included in the local installation example below and work with the demo API at https://api.mews-demo.com. These are publicly available test credentials from the Mews API documentation.

Using with NPX directly

To work directly with the published package, copy the following JSON and paste it in Claude, Cursor, or any other AI client that supports MCPs:

{
    "mcpServers": {
        "mews-mcp": {
            "command": "npx",
            "args": ["-y", "mews-mcp@latest"],
            "env": {
                "MEWS_CLIENT_TOKEN": "07AB1F14B55C49B8BDD6AD200158423B-273A4497AFF5E20566D7199DB3DC2BA",
                "MEWS_ACCESS_TOKEN": "BFD4298010F54B069F3DAD20015D53EA-D5561FADFBA4EFC8EA4C179C6BC461F",
                "MEWS_CLIENT": "mews-mcp/1.0.0",
                "MEWS_BASE_URL": "https://api.mews-demo.com"
            }
        }
    }
}

Note: The tokens above are public demo credentials from Mews API documentation. Replace the args path with your actual installation path.

License

MIT License - see LICENSE file for details.

Available Tools

53 tools
addAccountingItemsC

Adds new accounting items (charges, payments, etc.) to customer bills

Inputs: AccountingItems (required).

addAccountNotesC

Adds new account notes to the system and assigns them to specified accounts

Inputs: AccountNotes (required).

addAddressesC

Add new addresses to accounts

Inputs: Addresses (required).

addCompanyC

Adds a new company

Inputs: Name (required), TaxIdentifier, Email, Phone, +3 more.

addCustomerC

Create a new customer

Inputs: FirstName, LastName, Email, Phone, +11 more.

addLoyaltyMembershipsC

Adds new loyalty memberships to the system

Inputs: LoyaltyMemberships (required), ChainId.

addLoyaltyProgramsC

Adds new loyalty programs to the system

Inputs: LoyaltyPrograms (required), ChainId.

addLoyaltyTiersC

Adds new loyalty tiers to the system

Inputs: LoyaltyTiers (required), ChainId.

addPaymentC

Adds a new payment to a customer's bill

Inputs: CustomerId (required), Amount (required), PaymentMethodId (required), BillId, +2 more.

addReservationC

Adds a new reservation with the specified details

Inputs: ServiceId (required), RatePlanId (required), StartUtc (required), EndUtc (required), +7 more.

addTaskC

Adds a new task to the enterprise, optionally to a specified department

Inputs: Name (required), Description, DepartmentId, ServiceOrderId, +3 more.

addVouchersC

Adds new vouchers (discount codes, gift certificates) to the system

Inputs: Vouchers (required).

cancelReservationsC

Cancels specified reservations

Inputs: ReservationIds (required), CancellationReason, Notes, ChargeCancellationFee.

chargeCreditCardC

Charges a credit card and adds the resulting payment to a customer bill

Inputs: CustomerId (required), Amount (required), CreditCardData (required), BillId, +1 more.

deleteCompaniesC

Deletes specified companies

Inputs: CompanyIds (required).

deleteCustomersC

Deletes specified customers

Inputs: CustomerIds (required).

deleteLoyaltyMembershipsC

Deletes loyalty memberships

Inputs: LoyaltyMembershipIds (required).

deleteLoyaltyProgramsC

Deletes loyalty programs

Inputs: LoyaltyProgramIds (required).

deleteLoyaltyTiersC

Deletes loyalty tiers

Inputs: LoyaltyTierIds (required).

exportAccountingItemsC

Exports accounting items (charges, payments, etc.) in the specified format and period

Inputs: StartUtc (required), EndUtc (required), Format (required), AccountingItemIds, +2 more.

exportReservationsC

Exports reservations in the specified format and period

Inputs: StartUtc (required), EndUtc (required), Format (required), ReservationIds, +2 more.

getAllAccountingItemsB

Returns all accounting items (charges, payments, etc.) based on filter parameters. REQUIRED: At least one of the following filters must be specified: AccountingItemIds, RebatedItemIds, ClosedUtc, ConsumedUtc, or UpdatedUtc.

Inputs: AccountingItemIds, RebatedItemIds, CustomerIds, BillIds, +7 more.

getAllAccountNotesC

Returns all the account notes associated with the specified accounts within the chain

Inputs: AccountIds, CreatedUtc, UpdatedUtc, Limitation.

getAllAddressesB

Get all addresses associated with specified accounts

Inputs: AccountIds (required).

getAllAvailabilityBlocksA

Returns all availability blocks (reservations blocked by rate, space category, or space) based on filter parameters. Note: At least one filter must be provided (CreatedUtc, UpdatedUtc, CollidingUtc, AvailabilityBlockIds, or ExternalIdentifiers). The time interval must not exceed 100 hours.

Inputs: StartUtc (required), EndUtc (required), AvailabilityBlockIds, ServiceIds, +1 more.

getAllBillsC

Returns all bills by filter parameters, used for retrieving billing information

Inputs: BillIds, CustomerIds, CreatedUtc, UpdatedUtc, +2 more.

getAllCompaniesC

Returns all companies, optionally filtered by criteria

Inputs: CompanyIds, Names, CreatedUtc, UpdatedUtc, +1 more.

getAllCountriesB

Returns all countries supported by the API

Inputs: no named parameters.

getAllCurrenciesB

Returns all currencies supported by the API

Inputs: no named parameters.

getAllCustomersA

Get customers with filters. Note: At least one filter must be provided (CustomerIds, Emails, FirstNames, LastNames, LoyaltyCodes, CompanyIds, CreatedUtc, UpdatedUtc, or DeletedUtc). If no filters are specified, defaults to ActivityStates: ["Active"] to return all active customers. IMPORTANT LIMITATIONS: Date range filters (CreatedUtc, UpdatedUtc, DeletedUtc) have a maximum interval of 3 months and 1 day. All array filters have specific maximum item limits (typically 1000, except CompanyIds which is limited to 1).

Inputs: ChainIds, CreatedUtc, UpdatedUtc, DeletedUtc, +9 more.

getAllLanguagesB

Returns all languages supported by the API

Inputs: no named parameters.

getAllLoyaltyMembershipsA

Returns all loyalty memberships of the enterprise, optionally filtered by specific loyalty membership identifiers, activity states, or other filter parameters. Note this operation uses Pagination and supports Portfolio Access Tokens.

Inputs: Limitation (required), ChainIds, CreatedUtc, UpdatedUtc, +7 more.

getAllLoyaltyProgramsB

Returns all loyalty programs of the enterprise, optionally filtered by specific loyalty program identifiers or other filter parameters.

Inputs: ChainIds, CreatedUtc, UpdatedUtc, LoyaltyProgramIds, +3 more.

getAllLoyaltyTiersC

Returns all loyalty tiers of the enterprise, optionally filtered by specific loyalty tier identifiers or other filter parameters.

Inputs: ChainIds, CreatedUtc, UpdatedUtc, LoyaltyTierIds, +4 more.

getAllPaymentsC

Returns all payments based on filter parameters

Inputs: PaymentIds, CustomerIds, BillIds, CreatedUtc, +3 more.

getAllRatesC

Returns all rates (pricing) of the enterprise

Inputs: RateIds, ServiceIds, RateGroupIds, UpdatedUtc.

getAllReservationsC

Get reservations with filters. Note: The time interval between StartUtc and EndUtc must not exceed 100 hours.

Inputs: StartUtc (required), EndUtc (required), ReservationIds, CustomerIds, +2 more.

getAllServicesC

Returns all services offered by the enterprise

Inputs: ServiceIds, ServiceTypes, UpdatedUtc.

getAllSpaceCategoriesC

Returns all space categories of a service

Inputs: ServiceIds (required), SpaceCategoryIds, UpdatedUtc.

getAllSpacesC

Returns all spaces of the enterprise, or only those specified

Inputs: SpaceIds, ServiceIds, SpaceCategoryIds, UpdatedUtc.

getAllTasksA

Returns all tasks of the enterprise, filtered by identifiers or other filters. REQUIRED: At least one filter must be provided (TaskIds, DepartmentIds, ServiceOrderIds, CreatedUtc, ClosedUtc, or DeadlineUtc). LIMITATIONS: Date range filters (CreatedUtc, ClosedUtc, DeadlineUtc) have a maximum interval of 3 months and 1 day. Array filters (TaskIds, DepartmentIds, ServiceOrderIds) are limited to 1000 items each. The Limitation parameter with Count is mandatory for pagination.

Inputs: Limitation (required), TaskIds, DepartmentIds, ServiceOrderIds, +3 more.

getAllTaxationsB

Returns all taxations supported in tax environments

Inputs: TaxEnvironmentIds.

getAllTaxEnvironmentsB

Returns all tax environments supported by the API

Inputs: no named parameters.

getConfigurationB

Returns configuration of the enterprise and the client

Inputs: no named parameters.

getLanguageTextsC

Returns translations of texts in the specified languages

Inputs: LanguageCodes (required), Scope.

getRatePricingC

Returns prices of rates during the specified period

Inputs: RateIds (required), StartUtc (required), EndUtc (required).

mergeCustomersC

Merges two customers together

Inputs: SourceCustomerId (required), TargetCustomerId (required).

updateCompaniesC

Updates company information

Inputs: CompanyUpdates (required).

updateCustomersC

Updates personal information of existing customers

Inputs: CustomerUpdates (required).

updateLoyaltyMembershipsC

Updates information about the specified loyalty memberships. Note this operation supports Portfolio Access Tokens.

Inputs: LoyaltyMembershipUpdates (required), ChainId.

updateLoyaltyProgramsC

Updates information about the specified loyalty programs

Inputs: LoyaltyProgramUpdates (required), ChainId.

updateLoyaltyTiersC

Updates information about the specified loyalty tiers

Inputs: LoyaltyTierUpdates (required), ChainId.

updateReservationsC

Updates reservation properties

Inputs: ReservationUpdates (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    B3.2/5.0

    Scored across 53 tools

    Disambiguation5/5

    Every tool has a clearly distinct purpose targeting specific resources and actions, such as addCustomer vs. updateCustomers or getAllReservations vs. cancelReservations. The descriptions reinforce these distinctions, with no ambiguous overlaps that would cause agent misselection.

    Naming Consistency5/5

    Tool names follow a consistent verb_noun pattern throughout, using verbs like add, get, update, delete, export, and merge paired with specific nouns (e.g., addAccountingItems, getAllCustomers, updateReservations). There are no deviations in naming conventions, making the set highly predictable.

    Tool Count2/5

    With 53 tools, the count is excessive for typical MCP server purposes, making it heavy and potentially overwhelming for agents. While the domain is broad (hotel/enterprise management), many tools could be consolidated or scoped down to improve usability without losing functionality.

    Completeness5/5

    The tool surface provides comprehensive CRUD/lifecycle coverage across all major domains (customers, reservations, loyalty, accounting, etc.), including add, get, update, delete, and export operations. There are no obvious gaps, ensuring agents can handle full workflows without dead ends.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Hostkit MCP

      Hostkit MCPofficial

      hostkitpt
      A
      license
      B
      quality
      B
      maintenance
      MCP server for the Hostkit API, enabling management of properties, reservations, guests, invoices, and other property operations.
      36
      MIT

    • odh-mcp-server

      openfantasymap
      F
      license
      A
      quality
      D
      maintenance
      A FastMCP server that exposes hospitality data — accommodations, events, and gastronomy — through a unified MCP interface, supporting multiple worlds for real or fictional data.
      5
      -