Skip to main content
Glama

flights

Server Details

Cheapest round-trip across a flexible multi-month date window, with a buy/wait price verdict

Status
Healthy
Last Tested
Transport
Streamable HTTP
URL

Glama MCP Gateway

Connect through Glama MCP Gateway for full control over tool access and complete visibility into every call.

MCP client
Glama
MCP server

Full call logging

Every tool call is logged with complete inputs and outputs, so you can debug issues and audit what your agents are doing.

Tool access control

Enable or disable individual tools per connector, so you decide what your agents can and cannot do.

Managed credentials

Glama handles OAuth flows, token storage, and automatic rotation, so credentials never expire on your clients.

Usage analytics

See which tools your agents call, how often, and when, so you can understand usage patterns and catch anomalies.

100% free. Your data is private.
Tool DescriptionsA

Average 4.9/5 across 1 of 1 tools scored.

Server CoherenceA
Disambiguation5/5

With only one tool, there is no risk of confusion between tools. The tool's purpose is uniquely defined.

Naming Consistency5/5

A single tool 'search_flights' follows a clear verb_noun pattern (snake_case). No inconsistencies to evaluate.

Tool Count3/5

One tool is on the low end for a flight search server. While the tool is powerful and focused on flexible-date searches, it likely lacks coverage for specific date queries or auxiliary operations, making the count slightly thin.

Completeness3/5

The tool thoroughly handles flexible multi-month flight searches with price verdicts and cabin class support. However, it omits specific date searches and other common flight operations (e.g., airport lookup, booking management), leaving notable gaps for typical flight queries.

Available Tools

1 tool
search_flightsAInspect

Find the cheapest round-trip across a FLEXIBLE multi-month date window with a min/max trip length — e.g. "10–15 days, anytime Sep–Nov". This is the flexible-date search the big flight tools (Google Flights, Kayak, Skyscanner, Kiwi) keep behind their consumer UI and don't expose via API. Pass origin/destination as IATA codes, an earliest/latest date window, and min/max trip duration; get back a ranked list of the cheapest fares (with booking links) plus a price verdict — an honest read of whether the cheapest fare is low, typical, or high versus the route's usual price, or unknown when we lack a usable typical-price band (a price-level read, not a buy-now-or-wait timing prediction). Supports cabin class: pass cabin=business (or premium_economy/first) to find business-class deals — the verdict then judges the fare against that cabin's OWN typical prices, and metadata.deal_signal flags a business fare below its typical band. Use it for any flight question where the dates are flexible or the user wants the cheapest time to fly. If metadata.refresh_hint is present, you may repeat the same call after the suggested delay to get live-verified prices. If you can wait ~30s for the freshest fully-verified prices (e.g. you're an autonomous agent), set verify=full — the top result is then live-verified with no cached_indicators fallback.

ParametersJSON Schema
NameRequiredDescriptionDefault
chNoAcquisition channel tag (e.g. web, mcp, a campaign name). Encoded with the route into the affiliate link's sub_id so a future commission can be attributed to this channel in the Travelpayouts dashboard. Defaults to 'direct'. Sanitized to [a-z0-9-]; capped at 64 chars.direct
toNoDestination airport, 3-letter IATA code, UPPERCASE. Pass `anywhere` (or omit) to get the cheapest destinations from the origin instead of a specific route.
fromNoOrigin airport, 3-letter IATA code, UPPERCASE. Required for a specific route; with to=anywhere it may be omitted to auto-detect from the caller's IP country.
cabinNoCabin class: economy (default), premium_economy, business, or first. Use cabin=business to find business-class deals — the price verdict then judges the fare against the route's typical BUSINESS prices, and metadata.deal_signal flags a business fare below its own typical band. Non-economy cabins are priced via the live Google Flights source only (the cached calendar source covers economy), so results sample representative dates in the window.economy
top_nNoMaximum number of results to return, sorted cheapest-first.
latestNoLatest acceptable return date (ISO YYYY-MM-DD). Window from earliest must be ≤365 days. Required for a specific route; ignored in anywhere mode.
verifyNoHow hard to live-verify the top result against Google Flights (SerpApi). `false` (default): the check still runs automatically on a fresh search when the top isn't already a live price, within a client-aware time budget. `true`: force the check even on a cache hit. `full`: THOROUGH mode — wait for complete live verification and return the freshest prices with NO cached_indicators fallback (a longer ~35s budget; set it when you can wait, e.g. an autonomous agent). No-op unless a SerpApi key is configured.false
one_wayNoIf true, search one-way flights; return_date and duration_days will be null.
currencyNoResult currency, 3-letter ISO code UPPERCASE.USD
earliestNoEarliest acceptable departure date (ISO YYYY-MM-DD). Required for a specific route; ignored in anywhere mode.
max_daysNoMaximum trip duration in days (return - departure).
min_daysNoMinimum trip duration in days (return - departure).
max_transfersNoMaximum number of transfers/layovers per leg. 0 = nonstop only, 1 = up to 1 stop, etc. Omit for no filter.
Behavior5/5

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

With no annotations, the description fully discloses behavior: returns ranked list with booking links and a price verdict (low/typical/high/unknown). It explains the verify parameter's caching and live verification behavior, cabin class pricing sources, and the refresh_hint functionality. No contradictions.

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?

The description is thorough but somewhat verbose. It is well-structured, starting with the core purpose then detailing special features and parameter nuances. However, a few sentences could be trimmed without losing clarity, such as the aside about Google Flights and Kayak.

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

Completeness5/5

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

For a tool with 13 parameters, no output schema, and no sibling tools, the description covers all essential aspects: purpose, parameter usage, return value shape (list of fares with price verdict), special modes (anywhere, cabin class, verify), and timing considerations (refresh_hint, verify delays). It is remarkably complete.

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

Parameters5/5

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

Although schema coverage is 100%, the description adds significant context beyond parameter descriptions, such as how earliest/latest and min_days/max_days interact, the meaning of verify levels, and the cabin class verdict logic. This helps the agent understand parameter relationships and choose appropriate values.

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

Purpose5/5

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

The description explicitly states the tool's purpose: 'Find the cheapest round-trip across a FLEXIBLE multi-month date window'. It provides specific use cases (flexible dates, cheapest time to fly) and distinguishes itself from other flight tools by noting the flexible-date search is not typically exposed via API.

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

Usage Guidelines5/5

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

The description gives clear guidance on when to use this tool: for any flight question where dates are flexible or the user wants the cheapest time to fly. It explains how to use parameters like origin/destination, date window, trip duration, cabin class, and verify mode. It also advises on when not to use it (implicitly by specifying flexible dates).

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

Discussions

No comments yet. Be the first to start the discussion!

Try in Browser

Your Connectors

Sign in to create a connector for this server.

Resources