Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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:

Transport
Endpoint

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.

Sessions are held in memory and reset if the server restarts. If a session stops working, re-run initialize for a fresh Mcp-Session-Id.

Available tools

The Wingbits MCP exposes 17 read-only tools — every tool only reads data.

Aircraft & ownership

Tool
What it does

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

Tool
What it does

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

Tool
What it does

schedule_finder

Look up flight schedules

location_finder

Resolve places, airports, and coordinates

Live ADS-B

Tool
What it does

wingbits_api_realtime_flights

Query real-time flights from the live ADS-B feed

Power tools

Tool
What it does

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

Symptom
Cause
Fix

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?