Skip to main content
Glama

Search Flights

search_flights
Read-only

Find live flight options between any two cities, compare price, duration, stops and seats left, then get a booking link for chosen dates, passengers and cabin class.

Instructions

Search flights between any two cities worldwide on Go2Trip. Returns a curated set of options, each tagged with one or more categories:

  • best: the engine's recommended balance of price, total duration, and stops.

  • cheapest: lowest total price.

  • fastest: shortest total travel time. The categories overlap — a single flight can be both best and cheapest. Each option includes price, total durations, layovers, its categories, and a direct booking link on the Go2Trip site for the chosen market. Options may include seats_remaining — the number of seats left in this booking class at this price; values of 4 or fewer indicate limited availability.

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": {
      "origin": "<origin>",
      "destination": "<destination>",
      "departure_date": "<departure_date>"
    },
    "name": "search_flights"
  }
}

Input Schema

NameRequiredDescriptionDefault
adultsNoNumber of adult passengers (0–9)
marketNoGo2Trip country site to search and book on: 'uk' (United Kingdom), 'ae' (United Arab Emirates), 'qa' (Qatar), 'au' (Australia), 'cy' (Cyprus), 'cz' (Czech Republic), 'gr' (Greece), 'mt' (Malta) or 'sk' (Slovakia). Use the site of the user's country of residence when the conversation makes it clear and it is one of these; otherwise use 'uk'. Prices come back in that site's currency and the booking link opens on that site.uk
originYes3-letter IATA city or airport code (e.g. 'TLV', 'LON', 'MAD')
infantsNoNumber of infant passengers (0–9)
seniorsNoNumber of senior passengers (0–9)
childrenNoNumber of child passengers (0–9)
languageNoLanguage for the interactive results widget. English only.en
destinationYes3-letter IATA city or airport code (e.g. 'TLV', 'LON', 'MAD')
return_dateNoReturn date for round trips (YYYY-MM-DD). Omit for one-way.
flight_classNoCabin class: tour (economy), tourPlus (premium economy), business, or firsttour
departure_dateYesDeparture date in YYYY-MM-DD format

Output Schema

NameRequiredDescriptionDefault
queryYesThe search parameters, with defaults applied
totalYesTotal matches found, which may exceed `flights.length`
flightsYesMatching options, capped at 30

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv1.0.0

TDQS

A3.5/5.0
Behavior4/5

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

Annotations already declare readOnlyHint=true, openWorldHint=true and destructiveHint=false, so the safety profile is covered. The description adds genuinely useful behavior beyond that: results are curated and tagged with overlapping 'best'/'cheapest'/'fastest' categories, each option carries price, durations, layovers, a booking link, and possibly `seats_remaining` where values of 4 or fewer signal scarce availability. It does not cover what happens with zero results or whether prices are live/cached, which keeps it from a 5.

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?

Purpose is front-loaded in one sentence, with the category definitions presented as a tight bulleted list that is easy to scan. The bullets could arguably live in the output schema, but as written no sentence is padding.

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?

For an 11-parameter, open-world search with full schema coverage, existing annotations and an output schema, the description covers what an agent needs to interpret results — category semantics and the `seats_remaining` threshold. The main omission is result-set size or ordering behavior, which matters for a search tool.

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 every parameter — including the enum meanings for `market` and `flight_class` and the IATA code constraints — is already documented in the schema. The description adds nothing about individual parameters, so the baseline of 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 opening sentence gives a specific verb and resource ('Search flights between any two cities worldwide on Go2Trip'), which is unambiguous. It does not differentiate from any alternative tool, but no siblings are supplied, so there is nothing to distinguish against.

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?

The description offers no when-to-use or when-not-to-use guidance: it never says to use this for finding bookable options versus anything else, nor does it mention the round-trip vs one-way decision, currency/market selection, or how to handle multiple passenger types. All of that is left entirely to the input schema.

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

Deploy Server

Other Tools