flight-mcp-com

flight-mcp-com Flights API

The Flights API from flight-mcp-com — 2 operation(s) for flights.

GitHub OpenAPI

Operations 2

POST /v1/flights/search Search normalized flight offers #
POST /v1/flights/search/cached Search already-cached flight offers without an account #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/flight-mcp-com/openapi/flight-mcp-com-flights-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/flight-mcp-com/json-schema/flight-mcp-com-flight-search-input-schema.json
📊
JSONSchema
https://artifacts.apis.io/flight-mcp-com/json-schema/flight-mcp-com-anonymous-flight-search-input-schema.json
📊
JSONSchema
https://artifacts.apis.io/flight-mcp-com/json-schema/flight-mcp-com-anonymous-flight-search-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/flight-mcp-com/json-schema/flight-mcp-com-flight-search-response-schema.json

Other Resources

🔗
APIsJSON
https://artifacts.apis.io/flight-mcp-com/apis.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/flight-mcp-com:flight-mcp-com-flights-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

flight-mcp-com-flights-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Flight Mcp Com Flights API
  version: 0.1.0
  description: 'Operations tagged Flights across 2 of this provider''s published API definitions: flight-mcp-com-openapi.json, flight-mcp-com-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://flight-mcp.com
tags:
- name: Flights
paths:
  /v1/flights/search:
    post:
      summary: Search normalized flight offers
      operationId: searchFlights
      security:
      - bearerAuth: []
      - apiKeyHeader: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FlightSearchInput'
      responses:
        '200':
          description: Flight offers
          headers:
            ratelimit-limit:
              schema:
                type: integer
              description: Monthly plan limit
            ratelimit-remaining:
              schema:
                type: integer
              description: Monthly calls remaining
            ratelimit-reset:
              schema:
                type: integer
              description: Seconds until reset
            x-ratelimit-reset:
              schema:
                type: integer
              description: Reset time in Unix seconds
            x-request-id:
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlightSearchResponse'
        '400':
          $ref: '#/components/responses/Error'
        '401':
          $ref: '#/components/responses/Error'
        '429':
          $ref: '#/components/responses/Error'
        '500':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
        '503':
          $ref: '#/components/responses/Error'
        '504':
          $ref: '#/components/responses/Error'
      tags:
      - Flights
    servers:
    - url: https://flight-mcp.com
  /v1/flights/search/cached:
    post:
      summary: Search already-cached flight offers without an account
      description: Reads a weekly cache for ten supported routes only. Searches are fixed to one adult, one-way economy, USD, en-US, and US point of sale. This endpoint never starts a new external search, never consumes a monthly call, and returns CACHE_MISS when no suitable cached result exists. Create a free account to fetch the latest flight data.
      operationId: searchCachedFlights
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AnonymousFlightSearchInput'
      responses:
        '200':
          description: A non-billable cached flight-search result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnonymousFlightSearchResponse'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '429':
          $ref: '#/components/responses/Error'
        '500':
          $ref: '#/components/responses/Error'
        '503':
          $ref: '#/components/responses/Error'
      tags:
      - Flights
    servers:
    - url: https://flight-mcp.com
components:
  schemas:
    AnonymousFlightSearchInput:
      allOf:
      - $ref: '#/components/schemas/FlightSearchInput'
      - type: object
        oneOf:
        - properties:
            origin:
              const: JFK
            destination:
              const: LHR
        - properties:
            origin:
              const: LAX
            destination:
              const: JFK
        - properties:
            origin:
              const: SFO
            destination:
              const: JFK
        - properties:
            origin:
              const: LAX
            destination:
              const: SYD
        - properties:
            origin:
              const: HND
            destination:
              const: LAX
        - properties:
            origin:
              const: ICN
            destination:
              const: NRT
        - properties:
            origin:
              const: HKG
            destination:
              const: SIN
        - properties:
            origin:
              const: SIN
            destination:
              const: SYD
        - properties:
            origin:
              const: LHR
            destination:
              const: CDG
        - properties:
            origin:
              const: FRA
            destination:
              const: JFK
        properties:
          returnDate: false
          adults:
            const: 1
            default: 1
          children:
            const: 0
            default: 0
          infants:
            const: 0
            default: 0
          cabinClass:
            const: economy
            default: economy
          currency:
            const: USD
            default: USD
          locale:
            const: en-US
            default: en-US
          pointOfSaleCountry:
            const: US
            default: US
          maxResults:
            type: integer
            minimum: 1
            maximum: 20
            default: 20
          cacheTtlSeconds:
            type: integer
            minimum: 60
            maximum: 604800
            default: 604800
    FlightSearchInput:
      type: object
      additionalProperties: false
      required:
      - origin
      - destination
      - departureDate
      properties:
        origin:
          type: string
          pattern: ^[A-Z]{3}$
          description: Airport IATA code, or TYO to search both Haneda (HND) and Narita (NRT).
          examples:
          - HND
          - TYO
        destination:
          type: string
          pattern: ^[A-Z]{3}$
          description: Airport IATA code, or TYO to search both Haneda (HND) and Narita (NRT).
          examples:
          - SFO
          - TYO
        departureDate:
          type: string
          format: date
        returnDate:
          type: string
          format: date
        adults:
          type: integer
          minimum: 1
          maximum: 9
          default: 1
        children:
          type: integer
          minimum: 0
          maximum: 8
          default: 0
        infants:
          type: integer
          minimum: 0
          maximum: 8
          default: 0
        cabinClass:
          type: string
          enum:
          - economy
          - premium_economy
          - business
          - first
          default: economy
        currency:
          type: string
          pattern: ^[A-Z]{3}$
          default: JPY
        locale:
          type: string
          pattern: ^[a-z]{2,3}(-[A-Z]{2})?$
          default: ja-JP
        pointOfSaleCountry:
          type: string
          pattern: ^[A-Z]{2}$
          default: JP
          description: Requested sales-country context. Booking results match the requested currency and are not filtered by sales country.
        maxResults:
          type: integer
          minimum: 1
          maximum: 100
          default: 20
        cacheTtlSeconds:
          type: integer
          minimum: 60
          maximum: 259200
          default: 300
    ApiError:
      type: object
      required:
      - error
      properties:
        error:
          type: object
          required:
          - code
          - message
          - requestId
          properties:
            code:
              type: string
            message:
              type: string
            requestId:
              type: string
            details: {}
    AnonymousFlightSearchResponse:
      type: object
      required:
      - requestId
      - message
      - signUpUrl
      - query
      - offers
      - meta
      properties:
        requestId:
          type: string
        message:
          type: string
          description: Explains that a free account can fetch the latest data when cache is unavailable.
        signUpUrl:
          type: string
          format: uri
        query:
          $ref: '#/components/schemas/FlightSearchInput'
        offers:
          type: array
          items:
            $ref: '#/components/schemas/FlightOffer'
        meta:
          type: object
          required:
          - cached
          - billable
          - cacheFetchedAt
          - cacheExpiresAt
          - cacheAgeSeconds
          - cacheTtlSeconds
          - durationMs
          properties:
            cached:
              const: true
            partial:
              type: boolean
              description: True when this snapshot was obtained with at least one upstream search unavailable. Omitted for older cached results without coverage metadata.
            billable:
              const: false
            cacheFetchedAt:
              type: string
              format: date-time
            cacheExpiresAt:
              type: string
              format: date-time
            cacheAgeSeconds:
              type: integer
              minimum: 0
            cacheTtlSeconds:
              type: integer
              minimum: 1
            durationMs:
              type: integer
              minimum: 0
    FlightSegment:
      type: object
      required:
      - origin
      - destination
      - departureAt
      - arrivalAt
      - marketingCarrier
      - flightNumber
      - durationMinutes
      properties:
        origin:
          type: string
          pattern: ^[A-Z]{3}$
        destination:
          type: string
          pattern: ^[A-Z]{3}$
        departureAt:
          type: string
        arrivalAt:
          type: string
        marketingCarrier:
          type: object
          required:
          - code
          - name
          properties:
            code:
              type: string
            name:
              type: string
        flightNumber:
          type: string
        durationMinutes:
          type: integer
          minimum: 1
        aircraft:
          type: string
    Quota:
      type: object
      required:
      - limit
      - used
      - remaining
      - resetAt
      properties:
        limit:
          type: integer
          minimum: 0
        used:
          type: integer
          minimum: 0
        remaining:
          type: integer
          minimum: 0
        resetAt:
          type: string
          format: date-time
    FlightItinerary:
      type: object
      required:
      - durationMinutes
      - stops
      - segments
      properties:
        durationMinutes:
          type: integer
          minimum: 1
        stops:
          type: integer
          minimum: 0
        segments:
          type: array
          minItems: 1
          items:
            $ref: '#/components/schemas/FlightSegment'
    FlightOffer:
      type: object
      required:
      - id
      - price
      - cabinClass
      - itineraries
      - fetchedAt
      properties:
        id:
          type: string
        price:
          type: object
          required:
          - amountMinor
          - currency
          properties:
            amountMinor:
              type: integer
              minimum: 0
            currency:
              type: string
              pattern: ^[A-Z]{3}$
        cabinClass:
          type: string
          enum:
          - economy
          - premium_economy
          - business
          - first
        itineraries:
          type: array
          minItems: 1
          maxItems: 2
          items:
            $ref: '#/components/schemas/FlightItinerary'
        seatsRemaining:
          type: integer
          minimum: 0
        fetchedAt:
          type: string
          format: date-time
    FlightSearchResponse:
      type: object
      required:
      - requestId
      - remainingApiCalls
      - query
      - offers
      - meta
      properties:
        requestId:
          type: string
        remainingApiCalls:
          type: integer
          minimum: 0
          description: Billable API calls remaining in the current UTC month after this request. Cache hits do not reduce this value.
        query:
          $ref: '#/components/schemas/FlightSearchInput'
        offers:
          type: array
          items:
            $ref: '#/components/schemas/FlightOffer'
        meta:
          type: object
          required:
          - cached
          - cacheTtlSeconds
          - cacheExpiresAt
          - durationMs
          - quota
          properties:
            cached:
              type: boolean
            partial:
              type: boolean
              description: True when at least one upstream search failed. This does not indicate inventory completeness. Omitted for older cached results without coverage metadata.
            cacheTtlSeconds:
              type: integer
            cacheExpiresAt:
              type: string
              format: date-time
            durationMs:
              type: integer
              minimum: 0
            quota:
              $ref: '#/components/schemas/Quota'
  responses:
    Error:
      description: API error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
    apiKeyHeader:
      type: apiKey
      in: header
      name: x-api-key
x-refined-from:
- flight-mcp-com-openapi.json
- flight-mcp-com-openapi.yml