Skip to main content
Glama

Search beach clubs

search_beach_clubs
Read-onlyIdempotent

Searches the BeachClubs.ae directory of beach clubs in the United Arab Emirates by name, hotel, area, emirate, family suitability, amenities and day pass price. Returns paginated club summaries with the BeachClubs.ae page link, a primary call-to-action link, price in AED (or a price-on-request note) and whether the club can be booked instantly on BeachClubs.ae.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "search_beach_clubs"
  }
}

Input Schema

NameRequiredDescriptionDefault
limitNoNumber of results per page, 1 to 50. Default 20.
queryNoFree text matched against club name, hotel and area (ranked highest), plus headline, description, amenity names and child policy, typo tolerant. Words such as family, kids, pool, adults only, cheap or quiet and emirate names (including abbreviations like RAK or DXB and Arabic names) are applied as filters.
offsetNoNumber of results to skip, for pagination. Default 0.
emirateNoEmirate filter. Accepts names, abbreviations (DXB, AD, AUH, SHJ, RAK, UAQ, FUJ) and Arabic names.
amenitiesNoOnly clubs that list all of these amenities.
family_friendlyNotrue returns only clubs with family-friendly listing status; false returns only adults-only listing status. Partial and empty statuses are excluded when set.
max_day_pass_priceNoMaximum day pass price in AED. Clubs whose price is on request are excluded when set.

Output Schema

NameRequiredDescriptionDefault
limitYes
totalYes
offsetYes
messageYes
resultsYes
next_offsetYes
suggestionsYes
applied_filtersYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / query / description
      Previous value: -"Free text matched against club name, hotel and area, typo tolerant. Words such as family, kids, pool, adults only, cheap or quiet and emirate names (including abbreviations like RAK or DXB and Arabic names) are applied as filters."New value: +"Free text matched against club name, hotel and area (ranked highest), plus headline, description, amenity names and child policy, typo tolerant. Words such as family, kids, pool, adults only, cheap or quiet and emirate names (including abbreviations like RAK or DXB and Arabic names) are applied as filters."
  2. Changed10 schema fields changed
    • addedInput schema / properties / amenities
      Added value: +{
      +  "description": "Only clubs that list all of these amenities.",
      +  "items": {
      +    "enum": [
      +      "pool",
      +      "kids_area",
      +      "cabanas",
      +      "beach_bar",
      +      "pool_bar",
      +      "spa",
      +      "water_sports",
      +      "valet_parking",
      +      "wifi",
      +      "dj_live_music",
      +      "adults_only_area",
      +      "vip_area",
      +      "restaurant",
      +      "showers",
      +      "lockers"
      +    ],
      +    "type": "string"
      +  },
      +  "maxItems": 5,
      +  "type": "array"
      +}
    • changedInput schema / properties / emirate / description
      Previous value: -"Filter by emirate, e.g. 'Dubai' or 'Abu Dhabi'."New value: +"Emirate filter. Accepts names, abbreviations (DXB, AD, AUH, SHJ, RAK, UAQ, FUJ) and Arabic names."
    • addedInput schema / properties / emirate / maxLength
      Added value: +50
    • changedInput schema / properties / family_friendly / description
      Previous value: -"Only return clubs flagged as family friendly."New value: +"true returns only clubs with family-friendly listing status; false returns only adults-only listing status. Partial and empty statuses are excluded when set."
    • addedInput schema / properties / limit / description
      Added value: +"Number of results per page, 1 to 50. Default 20."
    • changedInput schema / properties / max_day_pass_price / description
      Previous value: -"Only return clubs with a day pass price at or below this amount in AED."New value: +"Maximum day pass price in AED. Clubs whose price is on request are excluded when set."
    • addedInput schema / properties / offset
      Added value: +{
      +  "default": 0,
      +  "description": "Number of results to skip, for pagination. Default 0.",
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • changedInput schema / properties / query / description
      Previous value: -"Free text matched against club name, area and hotel name."New value: +"Free text matched against club name, hotel and area, typo tolerant. Words such as family, kids, pool, adults only, cheap or quiet and emirate names (including abbreviations like RAK or DXB and Arabic names) are applied as filters."
    • addedInput schema / properties / query / maxLength
      Added value: +200
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "http://json-schema.org/draft-07/schema#",
      +  "additionalProperties": false,
      +  "properties": {
      +    "applied_filters": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "amenities": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "emirate": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "family_friendly": {
      +          "type": [
      +            "boolean",
      +            "null"
      +          ]
      +        },
      +        "max_day_pass_price": {
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "sort": {
      +          "type": "string"
      +        },
      +        "text": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        }
      +      },
      +      "required": [
      +        "text",
      +        "emirate",
      +        "family_friendly",
      +        "amenities",
      +        "max_day_pass_price",
      +        "sort"
      +      ],
      +      "type": "object"
      +    },
      +    "limit": {
      +      "type": "integer"
      +    },
      +    "message": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "next_offset": {
      +      "anyOf": [
      +        {
      +          "type": "integer"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "offset": {
      +      "type": "integer"
      +    },
      +    "results": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "area": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "beachclubs_booking_url": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "child_policy": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "cta": {
      +            "additionalProperties": false,
      +            "description": "Primary link: BeachClubs.ae booking section for instant-book clubs, else the BeachClubs.ae page.",
      +            "properties": {
      +              "label": {
      +                "type": "string"
      +              },
      +              "url": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "label",
      +              "url"
      +            ],
      +            "type": "object"
      +          },
      +          "day_pass_price_aed": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "emirate": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "family_access": {
      +            "anyOf": [
      +              {
      +                "enum": [
      +                  "family-friendly",
      +                  "partial",
      +                  "adults-only"
      +                ],
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "family_friendly": {
      +            "type": [
      +              "boolean",
      +              "null"
      +            ]
      +          },
      +          "family_friendly_source": {
      +            "enum": [
      +              "listing",
      +              "child_policy",
      +              "unknown"
      +            ],
      +            "type": "string"
      +          },
      +          "headline": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "hotel_name": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "id": {
      +            "type": "string"
      +          },
      +          "instant_book": {
      +            "type": "boolean"
      +          },
      +          "name": {
      +            "type": "string"
      +          },
      +          "price_note": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "temporarily_closed": {
      +            "type": "boolean"
      +          },
      +          "url": {
      +            "description": "The club's BeachClubs.ae page.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "url",
      +          "cta",
      +          "id",
      +          "name",
      +          "emirate",
      +          "area",
      +          "hotel_name",
      +          "headline",
      +          "day_pass_price_aed",
      +          "price_note",
      +          "family_access",
      +          "family_friendly",
      +          "family_friendly_source",
      +          "child_policy",
      +          "temporarily_closed",
      +          "instant_book",
      +          "beachclubs_booking_url"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "suggestions": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "cta": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "label": {
      +                "$ref": "#/properties/results/items/properties/cta/properties/label"
      +              },
      +              "url": {
      +                "$ref": "#/properties/results/items/properties/cta/properties/url"
      +              }
      +            },
      +            "required": [
      +              "label",
      +              "url"
      +            ],
      +            "type": "object"
      +          },
      +          "name": {
      +            "type": "string"
      +          },
      +          "url": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "name",
      +          "url",
      +          "cta"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "total": {
      +      "type": "integer"
      +    }
      +  },
      +  "required": [
      +    "results",
      +    "total",
      +    "offset",
      +    "limit",
      +    "next_offset",
      +    "message",
      +    "suggestions",
      +    "applied_filters"
      +  ],
      +  "type": "object"
      +}
  3. First observed

TDQS

A3.5/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The annotations already declare readOnlyHint, idempotentHint and openWorldHint=false, so the safety profile is covered. The description adds some useful behavior detail — pagination, the price-on-request case, and the instant-bookable flag — but it says nothing about ordering/ranking of results, latency, or whether the directory is a fixed curated set, which are the remaining behavioral unknowns.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences with no filler: the first front-loads scope and filters, the second enumerates the return payload. The second sentence is dense but every clause (page link, CTA link, AED price, price-on-request, instant booking) corresponds to a distinct field an agent needs to know about.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present and full parameter documentation, the description need not explain return shapes in detail, and it is complete on scope and filtering. The only meaningful gap is routing: it never states that get_beach_club should be used to fetch details for a result returned here, which matters given three siblings.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so every parameter already carries its own documentation including emirate abbreviations, amenity enum, and the price-on-request exclusion rule. The description only restates the filter categories at a high level ('name, hotel, area, emirate, family suitability, amenities and day pass price'), adding no syntax or semantics beyond the schema, so the baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb and resource ('Searches the BeachClubs.ae directory of beach clubs in the United Arab Emirates') and enumerates the searchable dimensions, so the tool's function is unambiguous. It does not explicitly contrast itself with the sibling get_beach_club, so an agent must infer the summary-vs-detail split from the phrase 'paginated club summaries'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is only implied by the verb 'Searches' and the stated filtering dimensions; there is no explicit when-to-use statement, no guidance on when to prefer get_beach_club or request_booking_enquiry instead, and no mention of the natural follow-up booking flow. An agent can reasonably infer this is the entry point, but nothing steers it explicitly.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources