MCP integration
MCP integration
Connect your own AI agent or client (Claude, Cursor, VS Code, …) to Wingbits data via the Model Context Protocol (MCP). Your agent can query live and historical flights in natural language — with no data infrastructure to build. The connection is read-only: your agent reads Wingbits data, it never changes anything.
For what this enables at a product level, see AI / MCP data access. Prefer to use Wingbits inside our own app instead? See the Wingbits AI Assistant.
What you can do
Once connected, your agent can answer questions like:
"What's flying within 50 nm of JFK above 10,000 ft?"
"Which leasing-company X aircraft are currently grounded?"
"Any emergency squawks (7500 / 7600 / 7700) over Scandinavia today?"
Prerequisites
An MCP-compatible client (Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, …).
A Wingbits MCP API key — see Access & authentication.
The server is available over two transports:
Streamable HTTP (recommended)
POST https://mcp.wingbits.ai/mcp
SSE (legacy clients)
GET https://mcp.wingbits.ai/sse
Authentication for both transports: send your key in the X-API-Key header.
Connect your client
For clients that support remote MCP servers, point them at the Streamable HTTP endpoint and pass your key as a header:
Restart the client. wingbits should appear in its list of connected MCP servers, with the tools listed below.
Fallback: mcp-remote
If your client only supports stdio-based MCP servers, bridge to the remote endpoint:
Verify with curl
A successful initialize returns HTTP 200 with an Mcp-Session-Id header; tools/list then returns the tool catalog below.
Available tools
The Wingbits MCP exposes 17 read-only tools — every tool only reads data.
Aircraft & ownership
aircraft_finder
Find aircraft matching your criteria
aircraft_identity
Resolve an aircraft's identity (registration, type, operator)
operator_filter
Filter aircraft by operator
vip_aircraft_finder
Find notable / VIP aircraft
military_lookup
Look up military aircraft
Safety & anomaly signals
acas_incidents_finder
Find ACAS / TCAS collision-avoidance incidents
squawk_emissions_finder
Find emergency squawks (7500 hijack, 7600 radio failure, 7700 emergency)
gps_jamming_finder
Find GPS-jamming activity
gps_jamming_aircraft
Find aircraft affected by GPS jamming
Schedules & geography
schedule_finder
Look up flight schedules
location_finder
Resolve places, airports, and coordinates
Live ADS-B
wingbits_api_realtime_flights
Query real-time flights from the live ADS-B feed
Power tools
query_aviation_data
Run a structured query across aviation data
get_schema
Fetch the data schema (use before composing a query)
current_date_time
Get the current date/time for relative queries
The server also serves schema resources (schema://adsb_sampled, schema://flight_trace) and ready-made prompt templates (acas_incidents, emergency_squawk, identify_aircraft, gps_jamming).
Troubleshooting
tools/list or a tool call is rejected asking you to initialize
No session — you skipped initialize
Run the initialize handshake first, then send Mcp-Session-Id on every call
406 Not Acceptable
Missing Accept header
Always send Accept: application/json, text/event-stream
Session works, then breaks
Server restarted; the in-memory session is gone
Re-run initialize for a fresh Mcp-Session-Id
403 Forbidden on another path
Only /mcp and /sse are exposed
Use the documented endpoints and check your X-API-Key
Next steps
Want raw data instead? See the REST API quickstart and the Real-time stream (NATS).
How we keep the data trustworthy: Data integrity & proof-of-location.
Last updated
Was this helpful?
