Developers & AI agents

Guest2Host is a catalog of vacation rentals listed by their owners, each booked on the owner’s own site. Agents can use it through an MCP server or a REST API. Read access is free and needs no key.

MCP server

https://api.guest2host.com/mcp

Streamable HTTP, stateless, JSON responses. Every tool carries a title and read-only / write annotations.

search_stays	Find stays by place, dates (only open ones come back), guests, pets and nightly price.	read
get_stay	Full details: description, amenities, photos, approximate location, owner-reported ratings, calendar freshness.	read
check_dates	Is a window open? If not, the three nearest open windows of the same length.	read
get_booking_link	The owner’s own booking site, as a tracked guest2host.com/go link.	read
list_destinations	Where Guest2Host has stays, with counts.	read
send_inquiry	Email the owner a traveler’s question; the owner replies to the traveler. Rate limited.	write
apply_to_list	An owner applies to list their rental.	write

Owners: sign in for the host tools

The same endpoint takes an OAuth 2.0 sign-in (discovery at https://api.guest2host.com/.well-known/oauth-protected-resource) or an agent key from the dashboard as Authorization: Bearer. A signed-in owner also gets:

list_my_listings / get_my_listing	The signed-in owner’s listings, editable form, version.
create_listing	Add a listing; it goes live at once.
update_listing	Patch any listing fields, version-guarded.
update_price	Set or confirm the nightly “from” price.
set_rating	The Airbnb/Vrbo rating as the platform shows it.
add_photo_from_url	Fetch a photo; location data is removed and it is resized.
request_site_change / list_my_change_requests	Work on a site Guest2Host hosts.

REST API

The same operations over plain HTTPS. Full spec: /openapi.json (OpenAPI 3.1).

GET  https://api.guest2host.com/api/v1/stays?where=oregon&checkIn=2026-11-06&checkOut=2026-11-08&guests=4
GET  https://api.guest2host.com/api/v1/stays/{slug}
GET  https://api.guest2host.com/api/v1/stays/{slug}/dates?checkIn=…&checkOut=…
GET  https://api.guest2host.com/api/v1/stays/{slug}/booking-link
GET  https://api.guest2host.com/api/v1/destinations
POST https://api.guest2host.com/api/v1/stays/{slug}/inquiries
POST https://api.guest2host.com/api/v1/applications

Good to know

• Availability is read from owners’ calendars about every 30 minutes. Tell travelers to confirm on the owner’s site.
• Prices are each owner’s lowest nightly rate; totals are on the owner’s site.
• Ratings are reported by the owner from Airbnb or Vrbo. Guest2Host doesn’t check listings.
• Booking links go through guest2host.com/go so owners can see what we send them. Add via=<your-agent> to attribute clicks.
• Errors say what to fix. Limits: send_inquiry 5 per traveler per day; be reasonable with request rates.
• Every stay page carries schema.org VacationRental JSON-LD; /llms.txt and /llms-full.txt describe the site for language models.

Use is covered by the terms and privacy policy. Questions: contact us.