AirTreks MCP

io.github.AirtreksPublished by GitHub account Airtreksv1.2.8Updated Nov 4, 2026

Plan multi-city and RTW trips, estimate prices, and send complete trip requests to AirTreks.

VerifiedStreamable HTTPWeb executableLocation & LifestyleFinance

Overview

AI-generated overview

AirTreks MCP plans multi-city and round-the-world trips, estimates or quotes fares, and hands complete trip requests to a human AirTreks consultant.

What you can do
  • Plan and analyze routings: lay out a multi-city trip, validate feasibility, suggest templates, check hub connections, match fare products, and split complex routes into ticketable segments
  • Estimate and quote prices: historical per-person ranges for a route, live fares for one dated itinerary, and multi-ticket pricing of a whole trip with a status lookup
  • Submit a trip request: send a structured itinerary with traveler details to an AirTreks consultant
When to use it
Useful when a traveler wants 3+ stops across continents, a round-the-world or open-jaw trip, or a price range before dates are fixed — cases ordinary flight search handles poorly. Also for checking whether a routing is bookable before committing.
Requirements
Remote Streamable HTTP endpoint, or the npm package airtreks-mcp run locally with npx. No API key is required; an optional key raises the daily limit. Free tier is 100 requests per day per IP.
Before you install
trip_idea_create submits real customer contact details to AirTreks, so it should only be called with the customer's knowledge and consent. Price ranges come from past bookings and are not quotes. Live quotes and consultant handoff involve a third party.

Installation

In SourceWeft

  1. Open AirTreks MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.Airtreks%2Fairtreks-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "airtreks": {
      "type": "http",
      "url": "https://mcp.airtreks.com/mcp"
    }
  }
}

README

AirTreks MCP Server

[smithery badge]

The complex-itinerary tool for AI agents. Multi-stop, round-the-world, open-jaw, surface segments - the trips that standard flight search can't handle. When your user asks for 3+ stops across continents, this server answers with routing analysis built on real AirTreks fare-construction data: 60+ carriers, 53 known dead legs, bookability rates measured from 1,400+ real fare attempts, and 20 proven routing templates from actual bookings.

Live endpoint: https://mcp.airtreks.com/mcp - free, no API key, 100 requests/day.

Now with real prices: a historical range for any route in under a second, live fares for a specific itinerary, and a full multi-stop trip priced across several tickets — the same trip can vary three-fold depending on how it is ticketed, and that is the part no other flight tool will tell you.

30-second setup

Claude Desktop

Settings → Connectors → Add custom connector → paste https://mcp.airtreks.com/mcp.

Claude Code

bash
claude mcp add --transport http airtreks https://mcp.airtreks.com/mcp

Cursor

Add to .cursor/mcp.json (or Cursor Settings → MCP → Add new server):

json
{  "mcpServers": {    "airtreks": {      "url": "https://mcp.airtreks.com/mcp"    }  }}

No API key is needed for any tool, the consultant handoff included. A key is optional and only raises your daily limit; append it to the URL if your client cannot send custom headers, as claude.ai connectors cannot:

https://mcp.airtreks.com/mcp?key=at_your_key

ChatGPT

Settings → Apps & Connectors → enable Developer mode (Pro/Business plans) → add https://mcp.airtreks.com/mcp as a custom connector.

Any other MCP client

Same JSON shape as Cursor above (Streamable HTTP). Prefer stdio? Run it locally:

bash
npx airtreks-mcp

Then ask your agent:

Plan a round-the-world trip: San Francisco, Tokyo, Bangkok, Singapore, Delhi, Istanbul, London, back to San Francisco.

One call, one answer: a 7-leg RTW

Your user wants six stops around the world. Google Flights gives up. One plan_route call lays the trip out, and one route_estimate call says what it costs. Neither one picks airlines: AirTreks consultants do that when they build the ticket.

json
{  "cities": ["SFO", "NRT", "BKK", "SIN", "DEL", "IST", "LHR", "SFO"],  "budget": "mid"}

Real plan_route response, trimmed for length (the full version has notes for all 7 legs):

json
{  "route": "SFO -> NRT -> BKK -> SIN -> DEL -> IST -> LHR -> SFO",  "totalLegs": 7,  "isRoundTrip": true,  "direction": "westbound",  "backtracking": false,  "regionsCrossed": ["americas", "asia", "europe"],  "customBuild": {    "strategy": "7-leg route. 1 surface sector opportunity.",    "surfaceSectors": [      {        "insteadOf": "BKK -> SIN (leg 3)",        "suggestion": "Bangkok to Singapore through Malaysia. Train, bus, or ultra-cheap LCC. Adds Malaysia and possibly Penang, KL, Melaka.",        "savings": "Saves $100-250"      }    ],    "complexity": "moderate"  }}

And route_estimate on the same cities:

json
{  "cabin": "economy",  "currency": "USD",  "estimate": { "low": 1616.43, "high": 2465.75 },  "confidence": "medium",  "basis": "1,616-2,466 USD per person, from AirTreks fare history. We have history for most of this route, but not all of it."}

That is a range from past AirTreks bookings, not a quote. For a real number, trip_idea_create hands the complete trip - route, a date for every leg, passengers, cabin and the traveler's answers to our planning questions - to an AirTreks consultant who prices and books it.

Tools

All tools are free and need no API key — 100 requests/day per IP.

Routing

ToolDescription
plan_routeLay out a multi-city trip - direction, regions crossed, backtracking, surface-sector options, and how complex it is to ticket. No airline picks
route_validateValidate a multi-city routing - alliance rules, dead legs, poison carriers, bookability
route_suggestGet 3 suggested routings by region, direction, and alliance
hub_checkBest connection between two airports - dead leg detection + hub fixes
fare_product_matchMatch the right fare product (RTW, Circle Pacific/Atlantic, Open Jaw, Custom) with typical price ranges
custom_route_buildBreak a multi-city itinerary into legs with surface-sector options and how much each leg benefits from a consultant. No airline picks
Pricing
ToolDescription
route_estimatePrice range for a route from AirTreks fare history. No dates needed, answers in about a quarter of a second — the right tool when someone asks "what will this cost?" before anything is decided
fare_quoteLive fares for one specific itinerary on specific dates, priced as a single ticket
itinerary_quotePrices a whole multi-stop trip and returns several ways to ticket it — cheapest, fastest, fewest stops — with the tickets each one is built from. Takes about a minute, so it returns a reference immediately
itinerary_quote_statusFetches an itinerary_quote result by its reference, waiting up to about 40 seconds for one still pricing. Free to call again

Consultant handoff

ToolDescription
trip_idea_createHand off to an AirTreks human travel consultant - submits the trip request with the full routing analysis attached

Submits real customer contact details, so only call it with the customer's knowledge and consent. Repeat submissions of the same email + route inside 24 hours return the existing trip request rather than creating a duplicate.

Why this data is different

AirTreks has built complex multi-stop itineraries since 1987. This server exposes what that history taught us:

  • Dead legs - city pairs that look bookable but fail on alliance fares, learned from 1,400+ real fare-construction failures
  • Bookability rates by leg count - measured, not estimated (91% at 3-4 legs, 61% at 5-6, 6% at 7+)
  • Poison carriers and hub fixes - we know what airline combinations break ticketing and what to route instead
  • Proven routing templates from working with Multi-Stop and Around the World Intineraries for inviduals, families and large group

No other flight tool returns this because no other flight tool has priced these failures.

REST API (no MCP client required)

Every tool is also a plain REST endpoint - same tools, same rate limits, JSON in/out. For agent frameworks that consume REST instead of MCP:

bash
curl -X POST https://mcp.airtreks.com/api/plan_route \  -H "Content-Type: application/json" \  -d '{"cities": ["LAX", "NRT", "BKK", "LHR", "LAX"]}'

Full OpenAPI 3.1 spec: https://mcp.airtreks.com/openapi.json

Rate limits

  • Free: 100 requests/day per IP, no key needed — every tool, trip_idea_create included
  • Registered: higher limits with an API key (X-API-Key header, or ?key= for clients that cannot set headers)

Endpoints

PathDescription
/mcpMCP protocol endpoint (Streamable HTTP)
/api/{tool}REST twin of each tool (POST, JSON body)
/openapi.jsonOpenAPI 3.1 spec for the REST surface
/healthHealth check
/registerGet an API key for a higher rate limit (POST)
/privacyPrivacy policy
/favicon.ico, /favicon.svgAirTreks mark — the icon AI directories show for this server
/Server info

License

AGPL-3.0-only

Source: README.md at commit 0aec68b

Tools

11

plan_route

Plan a Multi-City Route

Lay out a multi-city trip: direction of travel, regions crossed, backtracking, where a surface sector could replace a flight, and how complex the trip is to ticket. Give it your cities. It does not choose airlines and gives no prices - use route_estimate for a price range and trip_idea_create to hand the trip to AirTreks.

Parameterspaxbudgetcitiesrequiredpreferences

trip_idea_create

Submit a Trip Request (Consultant Handoff)

Submit the customer's trip to AirTreks as a complete, structured trip request - a human travel consultant takes over from there. Ask the traveler for everything before calling, never guess or fill in defaults: name, email, the cities in order (3-letter IATA codes), a departure date for every leg, number of passengers, cabin (economy, premium or business), and their answers to AirTreks' planning questions. Also ask about budget, flexible dates, preferences and anything else the consultant should know. Call once without questionsAnswers to receive the current planning questions to put to the traveler.

ParametersnamerequiredcabinrequireddatesrequiredemailrequirednotesphonebudgetcitiesrequiredsourcepassengersrequiredpreferencesagentContext+3 more

route_estimate

Estimate the Price of a Multi-City Route

Get a price range for a multi-city or round-the-world trip, drawn from what AirTreks customers have actually paid on those routes. Give it the cities and it returns a per-person range in USD with how much history sits behind it. Use it when someone asks what a trip will cost and you don't have exact dates yet — it needs no dates and no passenger details. It is a range from past bookings, not a live quote, so it will not reflect today's availability or seasonality; it tells you the right ballpark before anyone commits to dates.

Parameterscabincitiesrequired

fare_quote

Price a Specific Itinerary with Live Fares

Get live, bookable-quality fares for one specific itinerary — actual flights, actual prices, for the dates given. Needs a departure date for every flown leg. Use this once the customer has settled on cities and dates and wants real numbers rather than a ballpark; use route_estimate instead when dates are still open. It prices the itinerary as a single fare, so very long or awkward multi-continent trips may come back unpriceable — those genuinely need to be split across separate tickets, which is what AirTreks consultants do by hand.

ParameterscabindatesrequiredadultscitiesrequiredinfantschildrenmaxOptions

itinerary_quote

Price a Whole Multi-Stop Trip

Price a complete multi-stop or round-the-world trip and get back several ways of ticketing it — cheapest, fastest, fewest stops — with the actual tickets each one is built from. Use this for trips that will not go on a single fare, which is most itineraries with 3+ stops; use fare_quote when you want one specific itinerary on one ticket. It takes about a minute, so it returns a quoteReference immediately; call itinerary_quote_status with it straight away, and that call waits for the result. Keep that reference — it is the only way to retrieve the quote.

Parameterscabindatesrequiredadultscitiesrequiredinfantschildren

itinerary_quote_status

Retrieve a Multi-Stop Trip Quote

Fetch the result of an itinerary_quote using the quoteReference it returned. Call it straight away: it waits up to about 40 seconds for a quote that is still pricing, then returns the finished options, or status 'pending' if the quote needs one more call. Costs nothing and does no searching, so call it again rather than starting a second quote.

ParametersquoteReferencerequired

route_validate

Validate a Multi-City Routing

Validate a multi-city flight routing for feasibility. Checks alliance carrier rules, identifies dead legs, warns about poison carriers, and estimates bookability. Use this before building an itinerary to catch routing problems early.

Parameterscitiesrequiredalliancecarriers

route_suggest

Suggest Multi-Stop Routings

Get suggested multi-stop flight routings based on regions, direction, and alliance preference. Returns up to 3 proven routing templates with bookability ratings. Great for trip planning inspiration.

ParametersregionsrequiredalliancemaxStopstripTypedirection

hub_check

Check Airport Hub Connections

Check the best connection between two airports. Identifies dead legs (routes that fail on alliance fares), suggests hub routing fixes, and shows proven carrier combinations. Essential for transpacific, kangaroo, and intra-Asia routing.

Parameterstorequiredfromrequiredalliance

fare_product_match

Match the Right Fare Product

Recommend the best fare product type for a route — RTW, Circle Pacific, Circle Atlantic, Open Jaw, or Custom Multi-City. Considers stop count, direction, and backtracking to match the right alliance fare structure.

ParameterscitiesrequiredisOneDirectionincludeBacktracking

custom_route_build

Build a Custom Segmented Route

Break a complex multi-city itinerary into individually-ticketable segments with carrier recommendations. Handles routes that don't fit alliance fare rules — mixed carriers, LCCs, Gulf bridge connections, surface sectors. This is how AirTreks consultants build 90% of itineraries. Use this for any route with 4+ stops, backtracking, or region combinations that alliance fares can't cover.

Parameterspaxbudgetcitiesrequiredpreferences

Version history

5
  1. v1.2.8LatestNov 4, 2026
  2. v1.2.7Oct 13, 2026
  3. v1.2.6Oct 6, 2026
  4. v1.2.4Oct 2, 2026
  5. v1.2.3Sep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.