You connect Hostfully to your AI assistant with a small MCP server: a local program that wraps the Hostfully Platform API and exposes it as tools. Once connected, Claude, the Gemini CLI, or ChatGPT (via a hosted connector) can read your properties, leads, orders, and guests and answer questions in plain English.
The setup paths
It's free, takes about 15 minutes, and is read-only by default, so the assistant can look but not change anything. The three steps are the same whichever assistant you use:
- Get your API key. In Hostfully, keys are self-serve under Agency Settings on plans that include API access. Copy your agency UID too; most Platform API requests are scoped to it.
- Run the MCP server. A small Node.js file wraps the Platform API and exposes read-only tools for properties, leads (bookings and inquiries), orders, and guests.
- Ask in plain English. Point Claude, Gemini, or ChatGPT at the server and ask things like "which properties have check-ins this weekend?" or "show me the order on that lead."
The hosted API route
For a tool that has to keep running unattended, there is also a hosted path: the RapidEye API exposes Hostfully as a hosted connector, so the auth model and its limits are handled centrally and your code calls one consistent surface. The catalogue is machine-readable, so an AI agent can discover it mid-task and surface the next step itself.
