com.fostay/hotels

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

Agent-bookable hotels in Dubai, Abu Dhabi & Goa: live all-in AED prices, rate holds, payment links.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "hotels": {
      "url": "https://fostay.com/api/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (6)

• search_stays read-only

  Search hotels in Dubai, Abu Dhabi or Goa. For Dubai and Abu Dhabi, returns Fostay's hand-curated edit first (8 flagship stays with editorial verdicts), then catalog matches (~2,000 bookable hotels). For Goa, returns the best-reviewed hotels and resorts (hostels and homestays only when searched by name), optionally narrowed to one area. Use get_live_rates for prices. Results include a fostay_url where a human can view photos, live rates and book.

  Parameters:

  • city (required) — string — City or destination to search
  • area — string — Goa only: narrow to one area — candolim-calangute-baga (Candolim, Calangute & Baga); anjuna-vagator (Anjuna, Vagator & Assagao); morjim-mandrem-arambol (Morjim, Mandrem, Arambol & Siolim); panaji-old-goa (Panaji & Old Goa); south-goa-beaches (Colva, Benaulim, Varca & Cavelossim); palolem-agonda (Palolem & Agonda)
  • limit — integer — Max catalog results (default 10)
  • query — string — Optional hotel-name filter, e.g. 'Atlantis' or 'Rove'
  • min_rating — number — Minimum guest rating on a 10 scale, e.g. 8

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• get_live_rates read-only

  Live bookable room offers for one hotel and stay dates: total all-in price (AED), board (breakfast etc.), refundability and exact free-cancellation deadlines. For Goa, total_all_in counts GST, and any part the hotel collects at check-in is itemised separately (collected_by_hotel_at_checkin). The booking_url takes a human straight to this hotel on fostay.com to complete the booking.

  Parameters:

  • hotel_id (required) — string — Hotel id from search_stays (e.g. lp6556acf7)
  • checkin (required) — string — Check-in date, YYYY-MM-DD
  • checkout (required) — string — Check-out date, YYYY-MM-DD
  • adults — integer — Adult guests (default 2)
  • children — array — Children's ages at check-in, e.g. [7, 9]. IMPORTANT for families: child-inclusive rates price kids' breakfast and extras upfront — always pass ages when children travel.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• demand_calendar read-only

  Fostay's editorial demand calendar (UAE only — Dubai and Abu Dhabi; Goa has no event calendar yet): the upcoming date windows where Dubai and Abu Dhabi hotels predictably spike or sell out (GITEX, F1, NYE, Eid, school breaks...), each with a suggested book-by deadline. Use it to warn users about expensive dates or find event stays.

  Parameters:

  • city — string — Filter by city (default: both)

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

• when_to_go read-only

  Prices upcoming weekends (Fri–Sun, 2 nights) to find the cheapest times to stay. Pass hotel_id for one hotel across ~8 weekends, or just a city to compare Fostay's curated stays (Dubai, Abu Dhabi) or top-rated Goa hotels across the next ~6 weekends. Cheapest options first.

  Parameters:

  • city — string — Used when hotel_id is omitted
  • hotel_id — string — Optional hotel id from search_stays

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• prepare_booking

  Books everything except the payment: holds the chosen offer (real prebook — the price is locked while the hold lasts), registers the guest details, and returns a payment_url. The human opens that link, sees the exact stay summary, and pays in one step — the agent never handles card details. Confirm the guest's name and email with the user before calling. If the held price differs from what you quoted, this returns the final price and any change warnings — tell the user before sending them to pay.

  Parameters:

  • offer_id (required) — string — offer_id from get_live_rates
  • guest_first_name (required) — string
  • guest_last_name (required) — string
  • guest_email (required) — string — Guest's email — booking confirmation goes here
  • agent_name — string — Your client name for attribution, e.g. 'claude' or 'chatgpt'
  • guest_phone — string

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

• booking_status read-only

  Verify a completed booking: confirmation status, hotel confirmation code, stay and price. Requires the Fostay booking id AND the guest email it was booked under (both are in the guest's confirmation). Use after the human pays via a prepare_booking link.

  Parameters:

  • booking_id (required) — string — Fostay booking id, e.g. uzYG5ZTt9
  • guest_email (required) — string — Guest email on the booking

  Hints: read-only yes · destructive not declared · idempotent not declared · 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.