canonical: https://jentic.com/apis/flight-mcp.com/flight-mcp

# Flight MCP API

The Flight offer search API searches flight offers over REST and returns them in one normalized shape, so an agent reads a consistent result regardless of the underlying source. It offers a standard search for live offers and a separate cached search that answers from recent results without an account, and cache hits do not consume monthly plan calls. A lightweight health check lets a caller confirm the service is up before issuing a search.

## For AI agents

Search normalized flight offers over REST, or query already-cached offers without an account, and confirm service health before searching.

## Scope

Does not handle booking, payment, or seat selection. Use for searching normalized flight offers only.

## Capabilities

- Search live flight offers and get them back in one normalized shape
- Query already-cached flight offers without an account
- Reuse cached results so repeat searches do not spend monthly plan calls
- Check service health before issuing a search

## Use cases

### Agent flight search

An AI agent connected through Jentic answers a travel question by calling the flight search endpoint and reading back offers in one normalized shape, so it can compare options without the developer reconciling different providers' result formats by hand.

Example prompt: Search flight offers for a route and date and return the normalized list to the model to compare

### Cost-aware repeat lookups

A monitoring tool checks fares repeatedly by using the cached search, which answers from recent results without an account and does not consume monthly plan calls on a cache hit, so frequent polling stays cheap.

Example prompt: Poll the cached search endpoint for a route to detect a fare change without spending plan calls

### Normalized provider comparison

A trip-planning assistant leans on the single normalized shape of each offer to line up itineraries side by side, checking service health first so a search is only issued when the backend is available.

Example prompt: Confirm the service is healthy, then search offers for two routes and present them in one comparable shape

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/v1/flights/search` | Search normalized flight offers |
| POST | `/v1/flights/search/cached` | Search already-cached flight offers without an account |
| GET | `/healthz` | Check service health |

## Key resources

- **Flights** — Search live flight offers or query already-cached offers
- **Status** — Check service health before searching

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 55 / 100
- **Maturity:** Foundational
- **Dimensions:**
  - Foundational Compliance: 93 / 100
  - Developer Experience & Jentic Compatibility: 65 / 100
  - AI-Readiness & Agent Experience: 31 / 100
  - Agent Usability: 94 / 100
  - Security: 55 / 100
  - AI Discoverability: 67 / 100
- **View full report:** https://jentic.com/apis/flight-mcp.com/flight-mcp/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring this flight-search API by hand means handling its bearer or API-key auth, choosing between the live search and the account-free cached search, and parsing the normalized offer shape yourself. Through Jentic you install once, import it from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** The flight-search API carries the route and dates in the request body, so rules bound which operations your agent may call, not which route. Limit it to the search operations it needs, and the account-free cached search and the health check stay available without any credential at all.
- **Credential handling:** Your flight-search API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'search flight offers' or 'find cached flight results', and Jentic returns the matching flight-search operation with its input schema so the agent calls the right endpoint without reading the reference docs.

## Related APIs

- **Amadeus** — Full travel platform with flight offers, pricing, and orders rather than a single normalized search
- **Duffel** — Books the flight once an offer is chosen, which Flight MCP does not do
- **Aviationstack** — Real-time flight status and schedules that complement an offer search

## FAQ

### What authentication does the Flight MCP API use?

The flight search endpoint accepts either a bearer token or an API key in the `x-api-key` header, per its OpenAPI spec. The health check and the cached-search endpoint need no credential. Through Jentic the key is stored encrypted by your own Jentic One instance and injected at call time, so it never lands in the agent's context.

### Is there a Flight MCP server?

Jentic connects the Flight MCP API directly from the API Directory, so you don't set up a separate server to use it: import it, store your credential once, and your agent calls the search and cached-search operations on demand, without extra tool definitions loaded into its context.

### Can I limit what my agent is allowed to do with the Flight MCP API?

Yes. The search parameters travel in the request body, so a rule bounds which operations the agent may call rather than which route. Allow only the search operations, and the agent can look up flight offers but reaches nothing else, with every call logged.

### Can I search flights without an account using the Flight MCP API?

Yes. The cached-search endpoint answers from recent results and needs no credential, and because it serves cache hits it does not consume monthly plan calls, which makes it suited to frequent polling.

### What are the rate limits for the Flight MCP API?

The OpenAPI spec does not state a numeric rate limit, though cache hits on the cached-search endpoint do not count against monthly plan calls. Check the vendor documentation at https://flight-mcp.com for current plan limits.

### How do I search flights through Jentic?

Search Jentic for 'search flight offers', which returns the Flight MCP search operation with its input schema, then issue the route and date and read the normalized offers back. To run it on your own infrastructure, install Jentic One from its GitHub repo.