Skip to main content
Glama
Sign In
OctoTrip Flights

OctoTrip Flights

Official
by OctoTrip
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

OctoTrip Flights MCP Server

Glama Score PulseMCP Glimind reliability Uptime skills.sh

Free, no-login MCP server for searching and comparing flights with real-time pricing from multiple airlines and booking platforms worldwide.

MCP Streamable HTTP Endpoint:

https://mcp.octotrip.app/flights/mcp

Demo

Related

Related MCP server: flights-mcp

Affiliate Disclosure

OctoTrip is free to use. Booking links contain affiliate attribution -- OctoTrip may earn a commission at no extra cost to you. Search results are ranked by price within each stop-count group, not by affiliate payout.

Quick Start

Add to your MCP client configuration:

{
  "mcpServers": {
    "octotrip-flights": {
      "url": "https://mcp.octotrip.app/flights/mcp"
    }
  }
}

No API key or login required.

Use with...

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "octotrip-flights": {
      "url": "https://mcp.octotrip.app/flights/mcp"
    }
  }
}

Add to your MCP settings:

{
  "mcpServers": {
    "octotrip-flights": {
      "url": "https://mcp.octotrip.app/flights/mcp"
    }
  }
}

Add to your Cline MCP settings:

{
  "mcpServers": {
    "octotrip-flights": {
      "url": "https://mcp.octotrip.app/flights/mcp"
    }
  }
}

MCP Badge

openclaw plugins install clawhub:@xltnapps/octotrip-flights

Install via Smithery:

npx -y @smithery/cli install xltnapps/octotrip-flights --client claude
hermes mcp add octotrip-flights --url https://mcp.octotrip.app/flights/mcp
hermes mcp test octotrip-flights

Or add to ~/.hermes/config.yaml:

mcp_servers:
  octotrip_flights:
    url: "https://mcp.octotrip.app/flights/mcp"

For MCP clients that only support stdio transport:

npx mcp-remote https://mcp.octotrip.app/flights/mcp

A complete MCP session using curl (initialize, list tools, call search):

# 1. Initialize
curl -s -X POST https://mcp.octotrip.app/flights/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0", "id": 1, "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "capabilities": {},
      "clientInfo": {"name": "example", "version": "1.0"}
    }
  }'

# 2. List tools
curl -s -X POST https://mcp.octotrip.app/flights/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "id": 2, "method": "tools/list"}'

# 3. Search
curl -s -X POST https://mcp.octotrip.app/flights/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0", "id": 3, "method": "tools/call",
    "params": {
      "name": "search",
      "arguments": {
        "origin": "FRA",
        "destination": "BCN",
        "departure_date": "2026-08-01"
      }
    }
  }'

Transport: stateless streamable HTTP. Responses use text/event-stream (SSE). No session persistence or resumability. Rate limit: 1 request/second with burst capacity of 5.

Tool: search

Searches live flight offers between an origin and destination for given travel dates. Supports one-way and round-trip searches with flexible passenger counts and cabin class. Returns price-ranked results grouped by number of stops, showing the cheapest options from multiple airlines and booking platforms. The tool queries external flight aggregator APIs in real time and includes affiliate booking links. It does not book flights, modify reservations, charge users, or store user data.

Parameters

Parameter

Type

Required

Default

Description

origin

string

yes

--

Departure city, airport name, or IATA code (e.g. "Frankfurt", "JFK")

destination

string

yes

--

Arrival city, airport name, or IATA code

departure_date

string

yes

--

Departure date (YYYY-MM-DD, DD.MM.YYYY, or natural-language)

return_date

string

no

--

Return date for round-trip. Omit for one-way

adults

integer

no

1

Number of adult passengers (1-9)

children

integer

no

0

Number of children aged 2-11 (0-9)

infants

integer

no

0

Number of infants under 2 (0-9)

trip_class

string

no

"Y"

Cabin class: Y for economy, C for business

currency

string

no

"EUR"

ISO 4217 currency code (EUR, USD, GBP, etc.)

locale

string

no

"en"

Response language code (en, de, etc.)

Response Format

Results are grouped by number of stops with the cheapest options per group:

{
  "results": [
    {
      "airline": "Lufthansa",
      "airline_code": "LH",
      "alliance": "Star Alliance",
      "flight_numbers": ["LH120", "LH121"],
      "is_direct": true,
      "stops": 0,
      "total_duration_minutes": 110,
      "outbound": {
        "departure": "FRA",
        "arrival": "MUC",
        "departure_time": "18:15",
        "arrival_time": "19:10",
        "departure_date": "2026-07-15",
        "arrival_date": "2026-07-15",
        "duration_minutes": 55,
        "stops": 0,
        "legs": [
          {
            "flight_number": "LH120",
            "carrier": "Lufthansa",
            "aircraft": "Airbus A319",
            "departure": "FRA",
            "arrival": "MUC",
            "departure_time": "18:15",
            "arrival_time": "19:10",
            "departure_date": "2026-07-15",
            "arrival_date": "2026-07-15",
            "duration_minutes": 55
          }
        ]
      },
      "return": { ... },
      "price": 292.39,
      "currency": "EUR",
      "baggage": "No checked bag, Cabin bag: 1 piece(s)",
      "gate": "City.Travel",
      "booking_url": "https://...",
      "link_type": "affiliate",
      "affiliate_disclosure": "This link contains affiliate attribution. OctoTrip may earn a commission at no extra cost to you.",
      "tags": ["convenient_ticket", "direct"]
    }
  ],
  "total": 6,
  "total_available": 876,
  "origin_resolved": { "iata": "FRA", "name": "Frankfurt Airport", "city": "Frankfurt am Main", "country_code": "DE" },
  "destination_resolved": { "iata": "MUC", "name": "Munich Airport", "city": "Munich", "country_code": "DE" },
  "validity": "Results and booking links are valid for approximately 15 minutes.",
  "query": { ... }
}

Result Validity

Search results and booking links are valid for approximately 15 minutes. Flight prices are determined through a real-time bidding process and are not guaranteed beyond this window. If a user wants to book, they should do so promptly. For stale results, run a new search.

Error Responses

The server returns structured errors with suggestions:

  • airport_not_found -- airport could not be resolved. Try an IATA code, city name, or airport name.

  • disambiguation_needed -- multiple airports found (e.g. "New York" returns JFK, LGA). Pick one and retry.

  • invalid_date -- date format not recognized. Use YYYY-MM-DD, DD.MM.YYYY, or similar.

  • no_results -- no flights available for the given criteria. Try different dates or a nearby airport.

Example Prompts

  • Find me the cheapest direct flight from New York to London in August

  • Compare flights from Frankfurt to Munich on July 15, round-trip returning July 22

  • I need a one-way flight from LAX to Tokyo next Friday, economy class

  • Search for 2 adults and 1 child flying from Barcelona to Paris on September 1

  • What's the cheapest business class flight from Dubai to Singapore this month?

Privacy

This server does not log IP addresses, search queries, or any user-identifiable data. See PRIVACY.md for full details including sample log entries.

Security

To report a vulnerability, see SECURITY.md.

License

MIT

Available Tools

1 tool
searchA
Read-onlyIdempotent
Inspect

Searches live flight offers between an origin and destination for given travel dates. Supports one-way (omit return_date) and round-trip searches with flexible passenger counts and cabin class. Use this when the user wants to compare available flights, airlines, prices, layovers, or booking links for a specific route. Do not use it for rental cars, hotels, trains, or general travel planning unless the user has flight-search intent. The tool queries external flight aggregator APIs in real time, returns price-ranked results grouped by number of stops, and includes affiliate booking links. Results and booking links are valid for approximately 15 minutes due to real-time airline pricing. It does not book flights, modify reservations, charge users, or store user data.

Inputs: origin (required), destination (required), departure_date (required), adults, +6 more. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    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

    TDQS

    A4.6/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of confusion between tools. The tool's purpose is clearly described and distinct.

    Naming Consistency5/5

    A single tool cannot be inconsistent. The name 'search' is a simple verb, but consistency is perfect by default.

    Tool Count3/5

    One tool feels thin for a server named 'OctoTrip Flights', which implies broader flight-related capabilities. The tool is well-defined, but the count is borderline for the apparent scope.

    Completeness2/5

    The server only provides flight search, lacking any booking, modification, or cancellation functionality. Agents cannot complete a flight-related task beyond searching, which is a significant gap for a flight server.

    Maintenance

    ActivitySlowing
    ResponsivenessLimited data

    Resources

    Related MCP Connectors

    Related MCP Servers

    Appeared in Searches