Hospitable MCP allows compatible AI agents to securely access your Hospitable account. Once connected, your AI can help manage properties, reservations, guest messages, payouts, calendars, and more.
This article explains how to connect an AI agent and what to expect.
Hospitable MCP is only available on Host, Professional, and Mogul plans.
What is Hospitable MCP?
Hospitable MCP (Model Context Protocol) is a server that lets AI agents interact with your Hospitable account in a structured and secure way.
Once connected, the AI can:
Retrieve data (properties, reservations, calendars, transactions)
Send guest messages
Help automate workflows and answer operational questions
How to connect an AI agent to Hospitable
To connect your AI tool to Hospitable:
Add the following MCP server URL to your AI agent:
https://mcp.hospitable.com/mcp
Follow the prompt to sign in to your Hospitable account
Authorize access when requested
Once connected, the AI agent will be able to use the MCP tools available for your account.
Adding the MCP Server in Popular AI Tools
Each AI client has its own setup flow for MCP servers. Use the guides below for step-by-step instructions:
ChatGPT (Custom GPTs / MCP support): https://platform.openai.com/docs/mcp
Claude (Anthropic MCP): https://docs.anthropic.com/en/docs/mcp
Cursor (or MCP-compatible IDEs): https://cursor.sh/docs/mcp
MCP support and setup steps may vary by tool and are actively evolving. Always refer to the AI provider’s latest documentation.
Available tools
This is a limited initial release, and we are adding more features very quickly. Current tools include:
get-properties: Lists the authenticated user’s properties.get-property: Fetches one specific property by UUID.get-property-images: Returns the image gallery for a property.get-property-reviews: Lists reviews for a property.search-properties: Finds properties matching stay dates and guest counts.get-transactions: Lists account transactions.get-transaction: Fetches one specific transaction by UUID.get-payouts: Lists payouts for the account.get-payout: Fetches one specific payout by UUID.send-reservation-message: Sends a guest-facing message on a reservation thread.send-inquiry-message: Sends a guest-facing message on an inquiry thread.get-user: Returns the authenticated Hospitable user profile.get-community-user: Returns the authenticated community user profile.get-reservations: Lists reservations for selected properties with optional filters.get-reservation: Fetches one reservation by UUID or reservation code.get-reservation-messages: Returns the message history for a reservation.get-property-calendar: Returns a property’s calendar with availability, pricing, and stay rules.list-reservation-enrichment-data: Lists all accessible enrichment fields for a reservation.get-reservation-enrichment-data: Fetches one specific enrichment field for a reservation.get-inquiries: Lists inquiries for selected properties.get-inquiry: Fetches one specific inquiry by UUID.submit-feedback: Sends feedback when the MCP server is missing a needed capability.
Important Usage Notes
Start with read-only tools
Read tools (like reservations or properties) help the AI gather context before taking action. These are the safest place to begin, since they help the agent gather the right reservation, property, or guest context before taking action.
Messaging tools send real messages
Some tools can send messages directly to guests.
Messages sent through MCP are delivered to guests immediately. Only use messaging tools when you intend to contact the guest.
Plan availability
Hospitable MCP is available on the following plans:
Host
Professional
Mogul
Limitations
MCP sessions have a limited lifetime. If you are running long or multi-step workflows, the session may expire and require you to reconnect. We are actively working to improve session stability.
FAQ & Troubleshooting
Can I use it just for reading data?
Yes. Many available tools are read-only and are a good starting point.Why does the agent sometimes avoid optional includes?
Includes can expand responses with much more related data, which makes requests heavier and often unnecessary.Will my AI client see rate limits?
Yes. The server returns rate-limit metadata so compatible clients can make better decisions about pacing and retries.What if the AI client needs a capability that does not exist yet?
The server includes a feedback tool that can be used to request improvements or missing capabilities.What happens if I connect multiple AI tools?
You can connect multiple AI agents to Hospitable using the same MCP server URL. Each AI agent will have access to your Hospitable data based on the tools available to your account.
Note: All connected AI agents can take actions (like sending messages). Any changes made by one agent will apply directly to your Hospitable account.
Is my account safe with a third-party AI?
To use Hospitable's MCP, you must sign in to Hospitable and explicitly authorize access before any AI agent can connect. Once connected, the AI agent can access and act on your data through MCP tools. Only connect AI tools you trust.
Can I revoke access?
Access is granted when you connect an AI agent and authorize it.
To remove access, disconnect or remove the MCP server from the AI tool you used.
Note: Access control is managed from the AI client, not within Hospitable.
Which AI clients are supported?
Hospitable MCP works with AI tools that support the Model Context Protocol (MCP). Common examples include, but are not limited to:
ChatGPT
Claude
Cursor
MCP support depends on the AI provider and may change. Check the provider’s documentation for the latest setup and usage instructions.
Session expired or not found
If your AI agent returns an error like:
Server session expired or was not found. Send initialize again.This means the connection between the AI client and the Hospitable MCP server has timed out. MCP sessions have a limited lifetime and may expire during longer or multi-step workflows.To resolve this:
Restart the conversation or session in your AI client
If restarting doesn't resolve the issue, reconnect to the MCP server using the same URL:
https://mcp.hospitable.com/mcp
Re-authorize if prompted
Sessions may expire if the AI agent takes too long between requests or if the workflow involves many sequential steps. This is a known limitation of the current MCP implementation and is being actively improved.
Connection issues
If your AI agent cannot connect to Hospitable:
Verify you are using the correct MCP server URL:
https://mcp.hospitable.com/mcp
Check that your Hospitable account is on a supported plan (Host, Professional, or Mogul)
Make sure you have completed the authorization step in your AI client (review their documentation for setup instructions)
Try disconnecting and reconnecting the MCP server in your AI client's settings
Why did my session expire mid-conversation?
MCP sessions have a limited duration. If the AI agent takes too long between requests or runs a complex multi-step workflow, the session may time out. We are actively working on improving session stability.
If this happens, start a new conversation or session in your AI client — this will automatically create a fresh connection.