FlightSeatMap

Airline seat maps, seat ratings, traveller reviews and seat alerts for 150+ airlines.

Documentation

FlightSeatMap MCP

Seat maps, seat ratings, traveller reviews and seat alerts for 150+ airlines, as a remote MCP server your AI assistant can call.

Ask "which seat should I pick on QF1?" and get the real cabin layout, the free seats ranked against what you care about, and what other travellers said about the one you're considering.

  • Server: https://mcp.flightseatmap.com/mcp
  • Transport: Streamable HTTP
  • Auth: none for the read-only tools; OAuth 2.1 for search and alerts
  • Docs: https://flightseatmap.com/mcp

Nothing needs installing. The server is hosted; you point your client at the URL.

Install

Claude Code

claude mcp add --transport http flightseatmap https://mcp.flightseatmap.com/mcp

Cursor

Install this plugin from the marketplace, or add the server directly in ~/.cursor/mcp.json:

{
  "mcpServers": {
    "flightseatmap": {
      "type": "streamable-http",
      "url": "https://mcp.flightseatmap.com/mcp"
    }
  }
}

VS Code

code --add-mcp '{"name":"flightseatmap","type":"http","url":"https://mcp.flightseatmap.com/mcp"}'

Claude Desktop

Settings → Connectors → Add custom connector, then paste the server URL.

Tools

Six tools are free and need no account:

ToolWhat it does
get_seatmapThe cabin layout for a flight: rows, cabins, which seats are free
find_best_seatsFree seats ranked against window, aisle, exit row, extra legroom, quiet zone, bulkhead, front, rear
get_seat_infoOne seat in detail — pitch, recline, power, galley and lavatory proximity
interactive_seat_finderA good default when the traveller hasn't said what they want yet
get_seat_reviewsTraveller reviews, with ratings and per-seat comments
discover_more_flight_toolsRelated flight and travel MCP servers

Four need a signed-in account, over OAuth:

ToolWhat it does
search_flightFetch fresh data for a flight not yet in the database
create_seat_alertEmail the traveller when a matching seat frees up
list_seat_alertsThe traveller's alerts, with departure countdowns
delete_seat_alertRemove an alert

Seat map, review and alert results render as interactive MCP Apps widgets in clients that support them.

Authentication

OAuth 2.1 with PKCE and dynamic client registration — there is no API key to request, and no form to fill in. Your client discovers everything it needs from the 401 challenge.

  • Protected resource metadata: https://mcp.flightseatmap.com/.well-known/oauth-protected-resource/mcp
  • Authorization server metadata: https://mcp.flightseatmap.com/.well-known/oauth-authorization-server
  • Written walkthrough: https://flightseatmap.com/auth.md

Scopes are read, write and search. Tools request only the scope they need.

What's in this repo

PathPurpose
plugin.jsonAgent Plugins manifest — loads in Cursor unchanged
mcp.jsonServer declaration, Agent Plugins form
.claude-plugin/plugin.jsonClaude Code plugin manifest
.mcp.jsonServer declaration, Claude Code form
.grok-plugin/plugin.jsonxAI Grok marketplace manifest
gemini-extension.jsonGemini CLI extension manifest
server.jsonManifest for the official MCP Registry
skills/Agent skills describing how to use the tools well
commands/Slash commands (/seatmap, /best-seats)

Five ecosystems, five manifest conventions, one server. mcp.json and .mcp.json hold the same endpoint in the two shapes different clients look for — change both together. .grok-plugin/plugin.json points its mcpServers at mcp.json rather than repeating it.

The seat data, the API and the site are a separate, closed-source product. This repo is the connection glue, and it is MIT licensed.

Notes

  • Availability reflects the seat map, not the airline's live booking inventory. A seat shown as free may already be gone.
  • Seat maps are keyed on flight number (QF1, BA117, UA900), not route. A date helps, because aircraft swap between dates.
  • Extra-legroom and exit-row seats usually carry a fee, and exit rows carry age and mobility requirements.

Support

support@flightseatmap.com · Privacy · Terms


FlightSeatMap is operated by Merchant Software Solutions Limited, a company registered in England and Wales (no. 14098922), The Old Court House, Clark Street, Morecambe, LA4 5HR.