AirLabs MCP Server for Windsurf 12 tools — connect in under 2 minutes
Windsurf brings agentic AI coding to a purpose-built IDE. Connect AirLabs through Vinkius and Cascade will auto-discover every tool. ask questions, generate code, and act on live data without leaving your editor.
ASK AI ABOUT THIS MCP SERVER
Vinkius supports streamable HTTP and SSE.
Vinkius Desktop App
The modern way to manage MCP Servers — no config files, no terminal commands. Install AirLabs and 2,500+ MCP Servers from a single visual interface.
{
"mcpServers": {
"airlabs": {
"url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}
}
}
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About AirLabs MCP Server
Connect your AirLabs Data API aviation platform to any AI agent and take full control of real-time flight tracking, airport intelligence, airline research, and schedule analysis through natural conversation.
Windsurf's Cascade agent chains multiple AirLabs tool calls autonomously. query data, analyze results, and generate code in a single agentic session. Paste Vinkius Edge URL, reload, and all 12 tools are immediately available. Real-time tool feedback appears inline, so you see API responses directly in your editor.
What you can do
- Real-Time Flight Tracking — Search active flights worldwide by airline, flight number, aircraft registration, or geographic area
- Flight Schedules — Access complete timetables for airlines and airport pairs with frequency and days of operation
- Flight Information — Get detailed status for specific flights including gates, terminals, and timing data
- Airport Database — Search 50,000+ airports worldwide by country, city, IATA/ICAO code, or name
- Airline Database — Research airlines globally with fleet sizes, hub airports, and operational status
- Route Networks — Analyze complete route portfolios for any airline with origin-destination pairs
- Fleet Composition — Examine airline fleets with aircraft types, registrations, ages, and operational status
- Nearby Airports — Find airports near any geographic coordinate with distance calculations
- Airport Delays — Check current delay statistics and on-time performance for any airport
- Aircraft Lookup — Research individual aircraft by hex code with registration and specification details
- Airport Autocomplete — Quick airport search with type-ahead suggestions for user-friendly identification
- Airport Flight Boards — Monitor all arrivals or departures at any airport with complete flight lists
The AirLabs MCP Server exposes 12 tools through the Vinkius. Connect it to Windsurf in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
How to Connect AirLabs to Windsurf via MCP
Follow these steps to integrate the AirLabs MCP Server with Windsurf.
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Add the server
Paste the JSON configuration above into mcp_config.json
Save and reload
Windsurf will detect the new server automatically
Start using AirLabs
Open Cascade and ask: "Using AirLabs, help me...". 12 tools available
Why Use Windsurf with the AirLabs MCP Server
Windsurf provides unique advantages when paired with AirLabs through the Model Context Protocol.
Windsurf's Cascade agent autonomously chains multiple tool calls in sequence, solving complex multi-step tasks without manual intervention
Purpose-built for agentic workflows. Cascade understands context across your entire codebase and integrates MCP tools natively
JSON-based configuration means zero code changes: paste a URL, reload, and all 12 tools are immediately available
Real-time tool feedback is displayed inline, so you see API responses directly in your editor without switching contexts
AirLabs + Windsurf Use Cases
Practical scenarios where Windsurf combined with the AirLabs MCP Server delivers measurable value.
Automated code generation: ask Cascade to fetch data from AirLabs and generate models, types, or handlers based on real API responses
Live debugging: query AirLabs tools mid-session to inspect production data while debugging without leaving the editor
Documentation generation: pull schema information from AirLabs and have Cascade generate comprehensive API docs automatically
Rapid prototyping: combine AirLabs data with Cascade's code generation to scaffold entire features in minutes
AirLabs MCP Tools for Windsurf (12)
These 12 tools become available when you connect AirLabs to Windsurf via MCP:
autocomplete_airport
Returns matching airports ranked by relevance with IATA/ICAO codes, full names, cities, countries, and airport types. Ideal for building airport search interfaces, type-ahead functionality, and airport identification when the user only knows part of the airport name or code. Essential for travel application development, airport search workflows, and user-friendly airport identification. AI agents should use this when users type partial airport names or codes and need quick suggestions, or when the exact airport code is unknown but a partial name is provided. Search airports by name or code with autocomplete suggestions
get_aircraft
Returns aircraft registration number, ICAO type code, manufacturer and model, owner/operator, registration country, year built, engine type and count, and current operational status. The hex code is a unique identifier assigned to each aircraft transponder and can be found in flight tracking data. Essential for aviation enthusiasts, aircraft tracking, fleet verification, and detailed aircraft research. AI agents use this when users have an aircraft hex code from flight tracking data and need to look up the full aircraft registration and specifications. Get information about a specific aircraft by hex code
get_airline_fleet
Returns all aircraft in the airline fleet with registration numbers, aircraft types (manufacturer and model), ICAO aircraft type codes, age in years, delivery dates, engine types, and current operational status (active, stored, retired). Essential for fleet analysis, aviation industry research, competitor intelligence, aircraft utilization studies, and airline operational profiling. AI agents use this when users ask "show me the Delta fleet", "what aircraft does Emirates operate", or need to analyze fleet composition, average fleet age, and aircraft diversity for a specific airline. Get the complete fleet composition of an airline
get_airline_routes
Returns route pairs (origin-destination airports), frequency of service, days of operation, aircraft types deployed on each route, and whether the route is seasonal or year-round. Essential for route network analysis, airline competitive intelligence, aviation market research, travel itinerary planning, and airline hub/spoke structure analysis. AI agents should reference this when users ask "show me all United routes", "what routes does Ryanair operate", or need to understand an airline route network for competitive analysis or travel planning. Get all routes operated by a specific airline
get_airlines
Supports filtering by country code, IATA code, ICAO code, airline name, or callsign. Returns airline details including IATA/ICAO codes, full name, country of registration, callsign, fleet size, founding year, hub airports, airline type (scheduled, cargo, charter), and operational status (active, inactive). Essential for airline industry research, competitor analysis, travel planning context, aviation market intelligence, and airline profile generation. AI agents should use this when users ask "show me all airlines in the US", "tell me about Lufthansa", "what airlines fly from Dubai", or need airline metadata to contextualize flight and fleet data. Search and retrieve airline database information
get_airport_delays
Returns average departure and arrival delays in minutes, delay trends compared to historical averages, on-time performance percentages, cancellation rates, and weather-related delay indicators. Essential for travel planning, delay prediction, passenger communication, airline operations coordination, and airport performance monitoring. AI agents should reference this when users ask "are there delays at JFK", "how is LAX performing today", or need to assess airport operational conditions that may affect flight schedules. Get current delay statistics for a specific airport
get_airports
Supports filtering by country code, city name, IATA code, ICAO code, airport name, or timezone. Returns airport details including IATA/ICAO codes, full name, location (city, state, country), geographic coordinates (latitude, longitude, elevation), timezone, airport type (large, medium, small), and operational status. Essential for airport identification, travel planning, geographic aviation research, multi-airport city analysis, and flight briefing preparation. AI agents should reference this when users ask "show me all airports in Germany", "find airports in Tokyo", "what is the ICAO code for Heathrow", or need airport metadata to contextualize flight queries. Search and retrieve airport database information
get_flight_info
g., "UA123" for United 123). Returns complete flight details including airline information, aircraft type and registration, departure and arrival airports with terminals and gates, scheduled and estimated/actual times, current flight status, delay indicators, and baggage claim information. Critical for passenger travel updates, detailed flight status queries, airline operations coordination, and travel itinerary verification. AI agents should use this when users ask "tell me about flight UA123", "what is the status of BA178", or need detailed information for a specific flight number. Get detailed information for a specific flight
get_flights
Supports filtering by airline IATA code (e.g., "UA" for United), flight number, aircraft registration (hex code), altitude range, speed, or geographic bounding box (lat/lng coordinates). Returns flight identification (flight IATA/ICAO codes), airline details, aircraft hex code and registration, departure and arrival airports with IATA/ICAO codes, scheduled and estimated/actual times, current position (latitude, longitude), altitude in meters, ground speed in km/h, heading direction, vertical speed, squawk code, and flight status (en-route, landed, scheduled, cancelled). Essential for real-time flight tracking, passenger pickup coordination, aviation operations monitoring, and live flight dashboards. AI agents should use this when users ask "show me all United flights", "track flights in this area", or need to search flights by airline, registration, or geographic area. Search for real-time active flights worldwide
get_flights_by_airport
Returns comprehensive flight lists with airline, flight number, aircraft type, origin/destination airport, scheduled and estimated/actual times, terminal and gate information, baggage claim (for arrivals), and current flight status (en-route, landed, scheduled, delayed, cancelled, diverted). Supports type parameter to filter by "departure" or "arrival" flights. Essential for airport operations management, passenger pickup coordination, ground handling planning, flight activity monitoring, and arrival/departure board displays. AI agents should reference this when users ask "what flights are departing from JFK", "show me all arrivals at LHR", or need to monitor airport traffic for a specific airport. Get all arriving or departing flights at a specific airport
get_nearby_airports
Returns all airports (large international, regional, and general aviation) within the search radius with distances from the coordinate, IATA/ICAO codes, names, locations, and airport types. Essential for travel planning, alternate airport identification, geographic aviation research, emergency diversion planning, and multi-airport city analysis. AI agents should use this when users ask "what airports are near these coordinates", "find airports within 100km of this location", or need to identify the nearest airports to a specific point for travel or logistics purposes. Find airports near a specific geographic location
get_schedules
Returns scheduled flights with airline, flight number, aircraft type, departure and arrival airports, scheduled times, frequency of service, days of operation, and aircraft registration if assigned. Supports filtering by airline IATA code, departure airport IATA, arrival airport IATA, date range, and flight number. Essential for travel planning, route analysis, schedule reliability studies, airline timetable research, and flight itinerary preparation. AI agents should reference this when users ask "what is the schedule from JFK to LAX", "show me all Delta flights from ATL", or need to analyze flight schedules between airports. Get flight schedules and timetables for airlines and airports
Example Prompts for AirLabs in Windsurf
Ready-to-use prompts you can give your Windsurf agent to start working with AirLabs immediately.
"Show me all active United Airlines flights right now with their current positions and destinations."
"What is the flight schedule from New York JFK to London Heathrow, and which airlines operate this route?"
"Are there any delays at Chicago O'Hare (ORD) right now, and what flights are currently departing?"
Troubleshooting AirLabs MCP Server with Windsurf
Common issues when connecting AirLabs to Windsurf through the Vinkius, and how to resolve them.
Server not connecting
AirLabs + Windsurf FAQ
Common questions about integrating AirLabs MCP Server with Windsurf.
How does Windsurf discover MCP tools?
mcp_config.json file on startup and connects to each configured server via Streamable HTTP. Tools are listed in the MCP panel and available to Cascade automatically.Can Cascade chain multiple MCP tool calls?
Does Windsurf support multiple MCP servers?
mcp_config.json. Each server's tools appear in the MCP panel and Cascade can use tools from different servers in a single flow.Connect AirLabs with your favorite client
Step-by-step setup guides for every MCP-compatible client and framework:
Anthropic's native desktop app for Claude with built-in MCP support.
AI-first code editor with integrated LLM-powered coding assistance.
GitHub Copilot in VS Code with Agent mode and MCP support.
Purpose-built IDE for agentic AI coding workflows.
Autonomous AI coding agent that runs inside VS Code.
Anthropic's agentic CLI for terminal-first development.
Python SDK for building production-grade OpenAI agent workflows.
Google's framework for building production AI agents.
Type-safe agent development for Python with first-class MCP support.
TypeScript toolkit for building AI-powered web applications.
TypeScript-native agent framework for modern web stacks.
Python framework for orchestrating collaborative AI agent crews.
Leading Python framework for composable LLM applications.
Data-aware AI agent framework for structured and unstructured sources.
Microsoft's framework for multi-agent collaborative conversations.
Connect AirLabs to Windsurf
Get your token, paste the configuration, and start using 12 tools in under 2 minutes. No API key management needed.