HolidayFox

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Search independent UK holiday stays, check live availability and exact prices, then open checkout.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "HolidayFox": {
      "url": "https://mcp.holidayfox.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (8)

• search_stays read-only

  Search HolidayFox for UK holiday accommodation — farm stays, glamping, shepherd huts, caravan and camping pitches, and self-catering cottages. Filter by area and by amenity/audience tags. When checkinDate and checkoutDate are supplied, each result carries the live total price for that exact stay and only genuinely bookable options are counted. Returns destination ids used by the other tools.

  Parameters:

  • area — string — Region key, lowercase and hyphenated, e.g. "cornwall", "north-devon", "peak-district".
  • tags — array — Optional facet filters, e.g. [{"key":"hot-tub","category":"AMENITY"}].
  • after — string — Pagination cursor from a previous search.
  • limit — integer — 1–25, default 10.
  • numDogs — integer — Dogs in the party. Affects availability at dog-friendly sites; not a separate charge here.
  • numAdults — integer — Default 2.
  • numInfants — integer
  • checkinDate — string — YYYY-MM-DD. Supply with checkoutDate for live stay pricing.
  • numChildren — integer
  • checkoutDate — string — YYYY-MM-DD.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_listing_details read-only

  Full facts about one HolidayFox destination: description, location, amenities, restrictions, check-in/out times, cancellation policy, whether it confirms instantly or by request, and every accommodation type with its size, sleeps, minimum stay and price. Data is live from the HolidayFox booking system.

  Parameters:

  • destinationId (required) — string — From search_stays, e.g. "dest-MGaRjAwxGUrG".
  • numDogs — integer — Dogs in the party. Affects availability at dog-friendly sites; not a separate charge here.
  • numAdults — integer
  • numInfants — integer
  • checkinDate — string — YYYY-MM-DD. With checkoutDate, prices each unit for that stay.
  • numChildren — integer
  • checkoutDate — string — YYYY-MM-DD.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• check_availability read-only

  Check which dates are free. With destinationId alone it returns the site-wide availability calendar. With accommodationTypeId it returns per-date availability and the party-adjusted nightly price for that one unit. Dates are YYYY-MM-DD and the window is limited to 120 days. Returns availability and nightly prices only; the full stay total comes from get_quote.

  Parameters:

  • destinationId (required) — string
  • startDate (required) — string — YYYY-MM-DD
  • endDate (required) — string — YYYY-MM-DD
  • numDogs — integer — Dogs in the party. Affects availability at dog-friendly sites; not a separate charge here.
  • numAdults — integer
  • numInfants — integer
  • numChildren — integer
  • accommodationTypeId — string — Optional — narrows to one unit type.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_reviews read-only

  Read published guest reviews for a HolidayFox destination — star ratings, what guests said, and any reply from the owner. Returns an average rating and the most recent reviews.

  Parameters:

  • destinationId (required) — string — From search_stays or get_listing_details.
  • limit — integer — Max reviews to return, 1–10, default 5.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• list_addons read-only

  List the optional extras a specific accommodation type offers — things like firewood, a hot-tub session, an extra guest, or breakfast — with their prices. Returns product ids accepted by get_quote as `addons`.

  Parameters:

  • destinationId (required) — string
  • accommodationTypeId (required) — string — From search_stays or get_listing_details.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_quote read-only

  Get the authoritative total price for a specific stay directly from the HolidayFox booking system, including any length-of-stay discount and any optional extras passed in `addons`. Returns a quote id for begin_checkout, so the checkout total matches this quote, extras included. Does not hold the dates or make a booking.

  Parameters:

  • accommodationTypeId (required) — string — From search_stays or get_listing_details.
  • checkinDate (required) — string — YYYY-MM-DD
  • checkoutDate (required) — string — YYYY-MM-DD
  • numAdults (required) — integer
  • addons — array — Optional extras to include, from list_addons. The quoted total includes them.
  • quantity — integer — Number of units, default 1.
  • numInfants — integer
  • numChildren — integer

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• begin_checkout

  Produce the secure HolidayFox checkout link for a quote. The guest opens the link and pays on holidayfox.com. This tool takes no payment and does not confirm a booking.

  Parameters:

  • destinationId (required) — string
  • accommodationTypeId (required) — string
  • quoteId (required) — string — The quote id returned by get_quote.
  • checkinDate (required) — string — YYYY-MM-DD — must match the quote.
  • checkoutDate (required) — string — YYYY-MM-DD — must match the quote.
  • numAdults (required) — integer
  • numInfants — integer
  • numChildren — integer

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• message_owner

  Send a guest's enquiry to the site owner by email; the owner replies to the guest directly. Suited to sold-out dates, questions the listing details leave open, and request-to-book sites. Requires the guest's name, email address and message.

  Parameters:

  • destinationId (required) — string — The site the enquiry is about.
  • guestName (required) — string — The guest's name, as they gave it.
  • guestEmail (required) — string — The guest's email, so the owner can reply. Must be a real address the guest gave you.
  • message (required) — string — The enquiry in the guest’s words — dates, party, and the specific question.
  • phone — string — Optional phone number, only if the guest offered it.
  • numAdults — integer
  • checkinDate — string — Optional YYYY-MM-DD the enquiry is about.
  • numChildren — integer
  • checkoutDate — string — Optional YYYY-MM-DD.

  Hints: read-only no · destructive no · idempotent no · open-world yes

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.