← Hide Table of Contents

MIDAS MCP Server: Installation and Setup

Step 1: Install and Enable the MIDAS MCP Server addon

The MIDAS MCP Server is available as an optional add-on for MIDAS v4.43 (or later) and can be purchased from the outset, or added to an existing system at a later stage.

To get MIDAS together with the MCP Server add-on, please visit mid.as/pricing.
To add the MCP Server add-on to an existing MIDAS booking system, sign in as an administrator and go to MIDAS Admin Options → Addons → Available Addons → MCP Server.

Once the MCP Server add-on is installed, you can configure it via MIDAS Admin Options → Addons, and select MCP Server.

Upon first access, you'll be prompted to enter your MCP Key to activate the addon. This initial key can be found in the email you received when you purchased the MCP Server add-on. The MCP Key acts as a password, and must be kept confidential. Anyone with this key, and access to your MIDAS URL, will be able to use the MIDAS MCP Server according to the permissions you have configured. You can change this key at any time.

Next, tick Enable MCP Server followed by Save Changes to enable the MIDAS MCP server.

You can also decide whether the MCP Server should be able to make changes to MIDAS, or whether it should be restricted to read-only access. Read-only mode is a good starting point if you simply want to test enquiries and availability checks before allowing an AI assistant to make changes on your behalf.

Optionally, you can also restrict access to specific IP addresses if your AI platform connects from a known, fixed address.

For more information on the available settings, please see MCP Server settings.

Once enabled, your MIDAS MCP Server will be available at a URL similar to:

https://your-midas-url/mcp.pl

Step 2: Connect your AI assistant

Choose your AI platform below for specific setup instructions. In each case, you will need your MIDAS MCP Server URL and your MCP Key from Step 1.

Other MCP-compatible platforms

Most other MCP clients follow a similar pattern: a server URL, and a custom HTTP header for authentication. Where prompted for connection details, use:

Server URL: https://your-midas-url/mcp.pl
Header name: X-MCP-Key
Header value: your-midas-mcp-key

If your platform only supports launching local command-line tools rather than connecting to a remote URL directly, you can normally still connect it using mcp-remote in the same way as the Claude Desktop configuration.

Other Headers

In addition to the required X-MCP-Key header, the MIDAS MCP Server also supports two additional optional headers:

X-Query-As: Connect with the MCP Server inheriting the permissions of a specific user account. To use, set this header's value to the email address of an existing user account within your MIDAS system.
X-MIDAS-DB: If you have multiple databases setup in your MIDAS system, this header can be used to control which database the MCP server interacts with. To use, set this header's value to the internal ID of whichever database you wish to connect to.

Testing your connection

Once connected, try a simple, read-only request first, such as asking your AI assistant to check the availability of one of your rooms on a specific date. If this works, the connection has been configured correctly. If you have enabled write access, you can then try asking it to add a test booking.

If the connection fails, double-check the URL, MCP key, and that the MIDAS MCP Server addon is enabled. See the Server Tools page for the full list of actions available once connected, or head over to the Troubleshooting page if you run into any issues.

Table of Contents