Skip to main content
Glama

MAQAMI Travel

getExperienceTourAvailability

Read-onlyIdempotent

Overview

Retrieve available dates and time slots for a specific tour so users can pick when to attend.

When to Use

  • Date pickers - Populate a calendar or slot selector on the tour page

  • Availability checks - Confirm a tour runs on the user's travel dates

  • Booking flow - Gate the checkout path until a valid slot is selected

What You Get

  • Available dates - Days the tour can be booked

  • Time slots - Start times per date where applicable

  • Capacity hints - Whether slots are still bookable

Quick Start

Provide the tour id in the URL path and the required language query parameter.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.6/5.0
Behavior3/5

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

Annotations already declare readOnly, idempotent, openWorld, and non-destructive, so the safety profile is covered. The description usefully adds the return shape (dates, time slots, capacity hints), but says nothing about auth needs, rate limits, or pagination—the kind of context that would lift it above the annotation baseline.

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?

Markdown headings make it skimmable and the purpose is front-loaded in the Overview. It is somewhat more formatted than a zero-parameter read tool needs, but no sentence is wasted.

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 no output schema, the description appropriately carries the burden of explaining the return (available dates, slots, capacity hints). It is nearly complete; the one gap is the undocumented relationship between the referenced id/language inputs and the empty schema.

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?

With zero declared parameters the baseline would be 4, but the description asserts a tour 'id' path parameter and a 'required language query parameter' that the input schema (empty properties) does not declare. This mismatch between prose and schema makes the parameter story ambiguous rather than illuminating.

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 Overview states a specific verb and resource: retrieve available dates and time slots for a specific tour. It's clear what the tool returns. It doesn't explicitly differentiate itself from nearby siblings like getExperienceTourBookingOptions or getExperienceTour, which is the only thing keeping it from a 5.

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

Usage Guidelines4/5

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

The 'When to Use' section gives three concrete scenarios (date pickers, availability checks, booking-flow gating), which is strong context. However, it names no alternatives and gives no 'when not to use' exclusions, so an agent must infer which sibling to prefer when booking options overlap.

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