# variflight-mcp

VariFlight's official MCP server puts flight search, connections, fares and airport weather inside your coding agent. An API key is required.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 33
- Author: variflight
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/variflight/variflight-mcp
- Updated: 2026-10-10
- HTML: https://affpapa.org/en/nevibecode/mcp/variflight-mcp

## What it does

Eight tools land in your agent. You can look up direct flights between two cities or airport codes on a given date, pull a single flight by its number, and list connecting options for a longer route. A separate tool covers comfort: on-time performance, aircraft type, cabin layout, meals and entertainment. There is also live aircraft tracking by tail number, a three-day airport weather forecast, an itinerary summary with the lowest fare and shortest duration, and raw cabin-level pricing between two cities.

It runs through `npx`, so nothing needs to stay running locally. You do need a VariFlight key, created in the console at `ai.variflight.com`; new accounts get ¥50 in trial credits. The key goes into `VARIFLIGHT_API_KEY`. The same tools are offered as a remote server over streamable HTTP, which skips the local process entirely, and clients with OAuth 2.1 can connect without a key and sign in when asked.

Paging is available on `searchFlightsByDepArr` and `getFlightTransferInfo` through `limit`, `offset` and `detail`. Setting `detail: "summary"` trims each result to its core fields, while `full` is the default and returns everything. Every page is billed as its own call, so on busy routes a small `limit` with `summary` keeps both the response and the bill down. One rule on codes: don't mix a city code and an airport code on the same side of a query — `BJS` for departure and `PEK` for arrival in one request won't work.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `VARIFLIGHT_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add variflight-mcp -e VARIFLIGHT_API_KEY=<VARIFLIGHT_API_KEY> -- npx -y @variflight-ai/variflight-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add variflight-mcp --env VARIFLIGHT_API_KEY=<VARIFLIGHT_API_KEY> -- npx -y @variflight-ai/variflight-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "variflight-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@variflight-ai/variflight-mcp"
            ],
            "env": {
                "VARIFLIGHT_API_KEY": "<VARIFLIGHT_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "variflight-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@variflight-ai/variflight-mcp"
            ],
            "env": {
                "VARIFLIGHT_API_KEY": "<VARIFLIGHT_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e VARIFLIGHT_API_KEY=<VARIFLIGHT_API_KEY> variflight-mcp npx -y @variflight-ai/variflight-mcp
```
Replace <…> with your own values

## When to use it
- find direct flights between two cities on a given date
- build a connecting itinerary for a long-haul route
- compare cabin-level fares and spot the cheapest option
- check on-time performance and cabin layout for a specific flight
- get a three-day weather forecast for an airport

## Example prompts
- Find direct flights from `PEK` to `SHA` on 2024-03-20, summary detail only
- Where is aircraft `B2021` right now
- Suggest itineraries from `BJS` to `SHA` on 2025-04-20 with the lowest price

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md