HolidayFoxHolidayfox
Partner LoginBecome a Partner

Model Context Protocol · Live

Build holiday bookings into your AI

The HolidayFox MCP server gives any AI assistant the tools to find someone a hotel, B&B, cottage, cabin, glamping or campsite stay, price it for real, and hand them a secure link to book. No API key. No SDK. One endpoint.

Connect your MCP client to

https://mcp.holidayfox.com/mcp
transport streamable HTTPauth nonepayment hosted checkout link

Start in one request

Everything is JSON-RPC 2.0 over HTTP POST. List the tools, then call one. Here is a search — add an area and dates to get live per-stay prices.

# what can it do?
curl -s https://mcp.holidayfox.com/mcp -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# find a dog-friendly stay in Devon for two, priced
curl -s https://mcp.holidayfox.com/mcp -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{
       "name":"search_stays",
       "arguments":{"area":"devon","checkinDate":"2026-07-10",
                    "checkoutDate":"2026-07-13","numAdults":2,"numDogs":1}}}'

The tools

Twelve tools covering the whole journey — discovery to a booking link. Read-only where it should be; nothing takes a payment.

Stays

search_stays

Search by area and amenity tags; dated searches return live totals.

get_listing_details

Full facts for one site: amenities, policies, every unit and price.

check_availability

Site calendar or per-unit nightly availability and rates.

list_addons

Optional extras — firewood, hot tub, an extra dog — with prices.

get_quote

The authoritative total, extras included, plus a quote id.

begin_checkout

A holidayfox.com link that resumes the exact quote to pay.

Activities · Trust

list_activities

Bookable experiences a site runs — sauna, kayak, class.

check_activity_slots

Bookable time slots in venue-local time, seats remaining.

quote_activity

Authoritative price for a chosen slot and party.

begin_activity_checkout

Opens the activity in the booking widget to confirm and pay.

get_reviews

Published guest reviews, an average, and owner replies.

message_owner

Send a guest enquiry to the owner when a stay is sold out.

How a booking flows

The assistant does the finding and pricing; the guest does the paying — on HolidayFox's hosted checkout, never in the chat.

  1. search_stays
    Returns matching destinations with live prices when dates are given.
  2. get_quote
    Server-authoritative total (extras included) and a quote id. Never sum nightly rates yourself.
  3. begin_checkout
    Returns a holidayfox.com link that resumes that exact quote — so the price in chat is the price paid.
  4. Guest pays on HolidayFox
    Hosted checkout with 3D Secure. No card details ever pass through the assistant.

Works with the tools you already use

Any MCP-capable client. Paste the endpoint — the tools appear automatically.

Claude

Add it as a custom connector in Claude Desktop or Claude Code. Search-in-chat, book on HolidayFox — the pattern the directory already lists travel brands with.

ChatGPT & Perplexity

ChatGPT apps are built on MCP; Perplexity Pro users add a custom connector by URL. Same server, no changes.

Intercom Fin · Chatbase

Put live booking into the chat widget on your own site — add the MCP server (or wire the tools as actions). No partnership required to pilot.

Your own agent

LangChain, the Vercel AI SDK, a raw client — anything that speaks MCP. The full guide is on GitHub.

Questions

Do I need an API key?

No. Search, availability, pricing and reviews are public data over unauthenticated streamable HTTP. There is nothing to sign up for to start building.

How is payment handled?

The assistant never touches card details. The checkout tools return a holidayfox.com link that resumes the exact quoted price; the guest pays on HolidayFox's hosted checkout with 3D Secure. This is the pattern every live travel integration uses, and it keeps the server within AI-platform policies.

What does HolidayFox list?

Independent stays worldwide — hotels, B&Bs, cottages, cabins, glamping and campsites, plus unique places and bookable experiences.

Is it stable enough to build on?

The tool set and schema are fixed at deploy time, tool failures return readable in-band errors so your agent can self-correct, and prices always come from the live booking system. See the GitHub docs for the full contract.