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

The Host Tools MCP server URL is:

https://app.hosttools.com/mcp

That is the only value you need. Host Tools uses standard OAuth 2.0 with PKCE to authorize MCP clients, and your assistant discovers the authorization endpoints from that URL on its own — you just approve access when prompted.

In your AI assistant, add a custom MCP server — in Claude this lives under Settings → Connectors — and enter https://app.hosttools.com/mcp as the server URL.
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 should see after connecting

A healthy connection exposes:

49 tools — the read, analytics, and write tools listed below.
2 resources — hosttools://user and hosttools://listings. Seeing only these two is normal and does not mean the connection is incomplete: the other resources are templates that your assistant fills in on demand (for example a specific listing or reservation), so they are not listed up front.
3 prompts — daily_briefing, guest_response, and pricing_review.

The quickest way to confirm everything works is to ask your assistant something like "list my Host Tools listings" or "show me next week's check-ins". If the connection shows as authorized but every request fails, check the server URL first — it should be exactly https://app.hosttools.com/mcp.

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_calendar — View availability, prices, and minimum nights for a listing
get_reservations — Search reservations by listing, date range, and status
get_reservation — Get full details for a specific reservation
get_quote — Get a price quote for specific dates and guest count
get_message_thread — Read the message history for a reservation
get_message_rules — List automated message rules
get_pricing_rules — List pricing rules for a listing, including ones inherited from a calendar rule group
get_reviews — Fetch guest reviews for a listing
list_accounts — List connected channel accounts (Airbnb, VRBO, Booking.com, etc.)
get_account — Get details for a specific connected account (never credentials)
get_user — Get your Host Tools user profile
list_help_articles — List Host Tools help center articles
get_help_article — Read the full text of a help center article
collect_date_range — Show a date range picker when a request needs dates you haven't given

Analytics tools

Ask your AI assistant to analyze performance across your portfolio:

get_headline_kpis — Scorecard for a date range: revenue, occupancy, ANR, and RevPAL in one call
get_occupancy_stats — Occupancy rate by listing, channel, month, or week
get_revenue_stats — Total revenue, average per booking, and fee breakdown
get_adr_stats — Average daily rate
get_revpar_stats — Revenue per available night
get_timeseries_stats — Revenue, bookings, occupancy, ANR, and length of stay over time
get_pace_stats — Booking pace against the prior period or the same period last year
get_listing_breakdown_stats — Revenue, occupancy, and ANR broken down per listing
get_channel_performance — Bookings and revenue broken down by channel
get_booking_pattern_stats — Booking lead times, length of stay, and guest counts
get_cancellation_stats — Cancellation rate and trends
get_reservation_status_stats — Reservations broken down by status (accepted, cancelled, pending)
get_gap_analysis — Identify unbookable gaps between reservations
get_turnover_stats — Same-day turnovers (back-to-back check-out and check-in)
get_check_ins_check_outs — Check-ins and check-outs within a date range
get_upcoming_reservations — Who is arriving or departing in the next few days
get_pricing_stats — Calendar prices compared with the rates you actually earned
get_review_stats — Average ratings and rating distribution, fetched live from the channels
get_review_analytics — Rating trends and review volume from stored reservation reviews
get_response_time_stats — Host response time to guest messages
get_response_time_breakdown — First response time by message type and over time
list_listing_groups — List your saved listing groups, so you can ask for stats by group
get_metric_definitions — Definitions for every Host Tools dashboard metric

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
help:read — Read Host Tools help center articles
webhooks:manage — Create and manage webhook subscriptions

Every tool is visible to your assistant regardless of which scopes you granted — a scope is checked when a tool actually runs, and a tool outside your granted scopes returns a permissions error instead of disappearing from the list.

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.

How do I use the Host Tools MCP server?