Summary
The Host Tools MCP server lets you connect AI assistants — like Claude, Cursor, or any MCP-compatible tool — directly to your Host Tools account. Once connected, you can manage listings, reservations, pricing, messages, and more through natural-language conversations without leaving your AI assistant.
⚠️ Important: The MCP server is designed for technically proficient users and developers. You'll need an MCP-compatible AI assistant and the ability to configure it to connect to an external OAuth provider.
Connecting your AI assistant
Host Tools uses standard OAuth 2.0 with PKCE to authorize MCP clients. Your AI assistant handles the authorization flow — you just approve access when prompted.
Configure your MCP-compatible AI assistant to connect to the Host Tools MCP server. The server advertises its endpoints automatically via the OAuth discovery document at
https://app.hosttools.com/.well-known/oauth-authorization-server.Your AI assistant will open an authorization page. Sign in to Host Tools if prompted.
Review the list of permissions the client is requesting and click Authorize to grant access.
Your AI assistant receives an access token and is ready to use. You can now ask it to manage your listings, reservations, and more.
💡 Pro tip: Access tokens expire automatically. Your AI assistant will refresh them in the background using the refresh token — you won't need to re-authorize unless you revoke access manually.
What you can do
Once connected, your AI assistant has access to a set of tools organized into three categories:
Read tools
Fetch data from your account to answer questions, build reports, or provide context to the AI:
list_listings — List all your properties
get_listing — Get full details for a specific listing
get_reservations — Search reservations by listing, date range, and status
get_reservation — Get full details for a specific reservation
get_calendar — View availability and pricing for a listing
get_message_thread — Read the message history for a reservation
get_reviews — Fetch guest reviews for a listing
get_message_rules — List automated message rules
get_pricing_rules — List pricing rules for a listing
get_quote — Get a price quote for specific dates and guest count
list_accounts — List connected channel accounts (Airbnb, VRBO, Booking.com, etc.)
get_account — Get details for a specific connected account
get_user — Get your Host Tools user profile
Analytics tools
Ask your AI assistant to analyze performance across your portfolio:
get_occupancy_stats — Occupancy rate by listing and date range
get_revenue_stats — Total revenue and trends
get_adr_stats — Average daily rate
get_revpar_stats — Revenue per available night
get_channel_performance — Bookings and revenue broken down by channel
get_booking_pattern_stats — Booking lead times and patterns
get_cancellation_stats — Cancellation rate and trends
get_review_stats — Average ratings and review counts
get_response_time_stats — Host response time to guest inquiries
get_pricing_stats — Pricing distribution and averages
get_gap_analysis — Identify unbookable gaps between reservations
get_turnover_stats — Turnover frequency and timing
Write tools
Make changes to your account through the AI assistant:
send_message — Send a message to a guest
set_prices — Update nightly prices on your calendar
set_availability — Block or unblock dates
create_reservation — Create a manual reservation
update_reservation — Update reservation details
cancel_reservation — Cancel a reservation
update_listing — Update listing settings
create_message_rule — Create a new automated message rule
pause_message_rule — Pause or unpause an automated message rule
create_pricing_rule — Create a new pricing rule
OAuth permission scopes
When authorizing an MCP client, you'll see a list of permission scopes. Each scope controls which tools the client can use. You can authorize a client with a subset of scopes to limit what it can access:
listings:read / listings:write — Read and update listing details
reservations:read / reservations:write — Read reservations and create/update/cancel them
calendar:read / calendar:write — Read and update calendar availability and prices
messages:read / messages:write — Read message threads and send messages to guests
messageRules:read / messageRules:write — Read and manage automated message rules
pricing:read / pricing:write — Read and create pricing rules
reviews:read — Read guest reviews
accounts:read — Read connected channel accounts
listingGroups:read / listingGroups:write — Read and manage listing groups and owner import links
user:read — Read your user profile
locks:read / locks:write — Read and manage smart lock settings
webhooks:manage — Create and manage webhook subscriptions
Which AI assistants work with the MCP server?
Any AI assistant or tool that supports the Model Context Protocol (MCP) and OAuth 2.0 with PKCE can connect to the Host Tools MCP server. This includes Claude (via Claude.ai or the Claude desktop app), Cursor, and other MCP-compatible developer tools.
How do I revoke access for an AI assistant?
Token revocation is supported via the standard OAuth revocation endpoint (POST /oauth/token/revoke). Most MCP clients include a "disconnect" or "revoke access" option that handles this automatically. If your client doesn't, contact Host Tools support and we can revoke the token for you.