BRONLA

Check Hotel Availability

check_hotel_availability

Read-only

Mehmonxonada sana va mehmonlar uchun bo'sh xonalarni, bron ID'larini tekshiradi.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "listing_slug": "<listing_slug>",
      "check_in": "<check_in>",
      "check_out": "<check_out>"
    },
    "name": "check_hotel_availability"
  }
}

Input Schema

Name	Required	Description
`rooms`	No	Kerakli xonalar soni.
`adults`	No	Kattalar soni.
`check_in`	Yes	Kirish sanasi: YYYY-MM-DD yoki dd-mm-yyyy (masalan 2026-06-19).
`children`	No	Bolalar soni.
`check_out`	Yes	Chiqish sanasi (tun hisoblanmaydi): YYYY-MM-DD yoki dd-mm-yyyy.
`listing_slug`	Yes	Qidiruv natijasidagi e'lon `slug` qiymati.

Output Schema

Name	Required	Description
`hint`	No	Xatoni qanday tuzatish haqida ko'rsatma.
`note`	No	Bron bo'yicha eslatma.
`error`	No	Xato kodi; faqat tool bajarilmaganda keladi.
`found`	No	Mehmonxona topildimi.
`detail`	No	Upstream API xatosi tafsiloti.
`nights`	No	Tunlar soni.
`check_in`	No	Kirish sanasi, YYYY-MM-DD.
`available`	No	Mehmonlarga yetarli bo'sh xona bormi.
`check_out`	No	Chiqish sanasi, YYYY-MM-DD.
`space_ids`	No	create_booking.space_ids uchun xona ID'lari.
`listing_slug`	No	Mehmonxona slug'i.
`requested_rooms`	No	So'ralgan xonalar soni.
`available_spaces`	No	Mos xonalar: id, name, guest, type, category.
`requested_guests`	No	So'ralgan mehmonlar soni.

Schema Changelog

Changes observed during successful MCP inspections.

Changed7 schema fields changedOct 6, 2026

addedInput schema / properties / adults / description
```
Added value: +"Kattalar soni."
```

addedInput schema / properties / check_in / description

Added value: +"Kirish sanasi: YYYY-MM-DD yoki dd-mm-yyyy (masalan 2026-06-19)."

addedInput schema / properties / check_out / description

Added value: +"Chiqish sanasi (tun hisoblanmaydi): YYYY-MM-DD yoki dd-mm-yyyy."

addedInput schema / properties / children / description
```
Added value: +"Bolalar soni."
```

addedInput schema / properties / listing_slug / description

Added value: +"Qidiruv natijasidagi e'lon `slug` qiymati."

addedInput schema / properties / rooms / description
```
Added value: +"Kerakli xonalar soni."
```

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "properties": {
+    "available": {
+      "description": "Mehmonlarga yetarli bo'sh xona bormi.",
+      "title": "Available",
+      "type": "boolean"
+    },
+    "available_spaces": {
+      "description": "Mos xonalar: id, name, guest, type, category.",
+      "items": {
+        "additionalProperties": true,
+        "type": "object"
+      },
+      "title": "Available Spaces",
+      "type": "array"
+    },
+    "check_in": {
+      "description": "Kirish sanasi, YYYY-MM-DD.",
+      "title": "Check In",
+      "type": "string"
+    },
+    "check_out": {
+      "description": "Chiqish sanasi, YYYY-MM-DD.",
+      "title": "Check Out",
+      "type": "string"
+    },
+    "detail": {
+      "description": "Upstream API xatosi tafsiloti.",
+      "title": "Detail"
+    },
+    "error": {
+      "description": "Xato kodi; faqat tool bajarilmaganda keladi.",
+      "title": "Error"
+    },
+    "found": {
+      "description": "Mehmonxona topildimi.",
+      "title": "Found",
+      "type": "boolean"
+    },
+    "hint": {
+      "description": "Xatoni qanday tuzatish haqida ko'rsatma.",
+      "title": "Hint"
+    },
+    "listing_slug": {
+      "description": "Mehmonxona slug'i.",
+      "title": "Listing Slug",
+      "type": "string"
+    },
+    "nights": {
+      "description": "Tunlar soni.",
+      "title": "Nights",
+      "type": "integer"
+    },
+    "note": {
+      "description": "Bron bo'yicha eslatma.",
+      "title": "Note",
+      "type": "string"
+    },
+    "requested_guests": {
+      "description": "So'ralgan mehmonlar soni.",
+      "title": "Requested Guests",
+      "type": "integer"
+    },
+    "requested_rooms": {
+      "description": "So'ralgan xonalar soni.",
+      "title": "Requested Rooms",
+      "type": "integer"
+    },
+    "space_ids": {
+      "description": "create_booking.space_ids uchun xona ID'lari.",
+      "items": {
+        "type": "integer"
+      },
+      "title": "Space Ids",
+      "type": "array"
+    }
+  },
+  "title": "HotelAvailabilityResult",
+  "type": "object"
+}

First observedOct 6, 2026

TDQS

C2.9/5.0

Behavior2/5

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

Annotations already declare readOnlyHint=true and openWorldHint=true, so safety is covered. The description adds nothing further: no indication of what the response includes (rates? room types? the referenced booking IDs?), no auth or rate-limit context. The 'bron ID'larini' phrase hints at extra behavior but is never explained.

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?

A single compact sentence with the core purpose front-loaded. It wastes little, though the unexplained booking-ID clause is dead weight rather than useful detail.

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

Completeness3/5

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

An output schema exists, so return values need not be described, and annotations cover the read-only profile. What is missing is routing guidance against the very similar sibling check_availability, which for a 6-parameter search tool is a meaningful gap.

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 description coverage is 100%, so all six parameters (including date formats and guest counts) are already documented in the schema. The description only restates 'dates and guests' and adds no format or constraint detail beyond it, 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 names a concrete verb (tekshiradi/checks) and resources (bo'sh xonalar/available rooms for a date and guests), so an agent can tell what it does. It does not distinguish itself from the sibling check_availability, and the trailing 'bron ID'larini tekshiradi' (checks booking IDs) muddies the scope rather than sharpening it.

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

Usage Guidelines2/5

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

There is no guidance on when to use this tool versus check_availability, search_hotels, or get_listing_details. The agent is left to infer the routing from the name alone, which is a real risk given the near-duplicate sibling check_availability.

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

All BRONLA tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?