Hotels

Working · 860 ms

com.fostay/hotelsv2.1.0 Domain verified

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

Maps & Travel

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://fostay.com/api/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

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.

booking_idstring, required

Fostay booking id, e.g. uzYG5ZTt9

guest_emailstring, required

Guest email on the booking

Tools (6)

booking_status

read-only

Argument	Type	Description
booking_id*	string	Fostay booking id, e.g. uzYG5ZTt9
guest_email*	string	Guest email on the booking

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "booking_id",
    "guest_email"
  ],
  "properties": {
    "booking_id": {
      "type": "string",
      "maxLength": 40,
      "minLength": 4,
      "description": "Fostay booking id, e.g. uzYG5ZTt9"
    },
    "guest_email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "maxLength": 254,
      "description": "Guest email on the booking"
    }
  }
}

demand_calendar

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.

read-only

Argument	Type	Description
city	string	Filter by city (default: both)

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "city": {
      "enum": [
        "Dubai",
        "Abu Dhabi"
      ],
      "type": "string",
      "description": "Filter by city (default: both)"
    }
  }
}

get_live_rates

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.

read-only

Argument	Type	Description
adults	integer	Adult guests (default 2)
checkin*	string	Check-in date, YYYY-MM-DD
checkout*	string	Check-out date, YYYY-MM-DD
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.
hotel_id*	string	Hotel id from search_stays (e.g. lp6556acf7)

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "hotel_id",
    "checkin",
    "checkout"
  ],
  "properties": {
    "adults": {
      "type": "integer",
      "maximum": 8,
      "minimum": 1,
      "description": "Adult guests (default 2)"
    },
    "checkin": {
      "type": "string",
      "description": "Check-in date, YYYY-MM-DD"
    },
    "checkout": {
      "type": "string",
      "description": "Check-out date, YYYY-MM-DD"
    },
    "children": {
      "type": "array",
      "items": {
        "type": "integer",
        "maximum": 17,
        "minimum": 0
      },
      "maxItems": 4,
      "description": "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."
    },
    "hotel_id": {
      "type": "string",
      "maxLength": 40,
      "minLength": 3,
      "description": "Hotel id from search_stays (e.g. lp6556acf7)"
    }
  }
}

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.

Argument	Type	Description
offer_id*	string	offer_id from get_live_rates
agent_name	string	Your client name for attribution, e.g. 'claude' or 'chatgpt'
guest_email*	string	Guest's email — booking confirmation goes here
guest_phone	string
guest_last_name*	string
guest_first_name*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "offer_id",
    "guest_first_name",
    "guest_last_name",
    "guest_email"
  ],
  "properties": {
    "offer_id": {
      "type": "string",
      "maxLength": 4000,
      "minLength": 10,
      "description": "offer_id from get_live_rates"
    },
    "agent_name": {
      "type": "string",
      "maxLength": 40,
      "description": "Your client name for attribution, e.g. 'claude' or 'chatgpt'"
    },
    "guest_email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "maxLength": 254,
      "description": "Guest's email — booking confirmation goes here"
    },
    "guest_phone": {
      "type": "string",
      "maxLength": 32
    },
    "guest_last_name": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1
    },
    "guest_first_name": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1
    }
  }
}

search_stays

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.

read-only

Argument	Type	Description
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)
city*	string	City or destination to search
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

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "city"
  ],
  "properties": {
    "area": {
      "enum": [
        "candolim-calangute-baga",
        "anjuna-vagator",
        "morjim-mandrem-arambol",
        "panaji-old-goa",
        "south-goa-beaches",
        "palolem-agonda"
      ],
      "type": "string",
      "description": "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)"
    },
    "city": {
      "enum": [
        "Dubai",
        "Abu Dhabi",
        "Goa"
      ],
      "type": "string",
      "description": "City or destination to search"
    },
    "limit": {
      "type": "integer",
      "maximum": 25,
      "minimum": 1,
      "description": "Max catalog results (default 10)"
    },
    "query": {
      "type": "string",
      "maxLength": 80,
      "description": "Optional hotel-name filter, e.g. 'Atlantis' or 'Rove'"
    },
    "min_rating": {
      "type": "number",
      "maximum": 10,
      "minimum": 0,
      "description": "Minimum guest rating on a 10 scale, e.g. 8"
    }
  }
}

when_to_go

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.

read-only

Argument	Type	Description
city	string	Used when hotel_id is omitted
hotel_id	string	Optional hotel id from search_stays

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "city": {
      "enum": [
        "Dubai",
        "Abu Dhabi",
        "Goa"
      ],
      "type": "string",
      "description": "Used when hotel_id is omitted"
    },
    "hotel_id": {
      "type": "string",
      "maxLength": 40,
      "minLength": 3,
      "description": "Optional hotel id from search_stays"
    }
  }
}