PlaneConnection’s MCP server exposes 88 tools across 26 domain modules, enabling
AI agents (Claude, CopilotKit, and other MCP-compatible clients) to read and
write flight operations data through a standardized protocol. The server runs as
a standalone server with persistent session management.
For setup and configuration instructions, see Set Up the MCP
Server.
Tools marked with a destructive badge create, modify, or delete real data. AI agents should
confirm with the user before invoking destructive tools. Read-only tools are safe to call without
confirmation.
Core Aviation and Flight Planning
These tools handle flight search, weather retrieval, fuel calculations, and the
AI aviation assistant.
| Tool | Description | Destructive |
|---|
search_flights | Search for available flights between airports by ICAO code and date. | No |
get_weather | Get real-time METAR/TAF weather information for an airport. Returns raw text, decoded wind, visibility, clouds, temperature, and flight category. | No |
calculate_fuel | Calculate fuel requirements for a flight given distance (NM), aircraft type, and reserve percentage. Uses built-in aircraft performance tables. | No |
ask_aviation_ai | Ask the PlaneConnect AI assistant about aviation topics. | No |
Example: Get weather
{
"tool": "get_weather",
"arguments": {
"airport": "KJFK"
}
}
Returns METAR and TAF data with decoded fields including flight category (VFR/MVFR/IFR/LIFR), wind, visibility, ceiling, and temperature/dewpoint spread.
Aircraft
| Tool | Description | Destructive |
|---|
list_aircraft | List all aircraft in the fleet. Filter by search text (tail number, make, model) and status (available, maintenance, reserved, grounded). | No |
get_aircraft | Get detailed aircraft information including equipment (autopilot, GPS, TCAS, de-ice, oxygen), performance specs (useful load, fuel capacity, cruise speed, range), and notes. | No |
Trips and Scheduling
| Tool | Description | Destructive |
|---|
get_aircraft_schedule | Get trips for a specific aircraft within a date range, filtered by tail number. | No |
search_trips | Search trips with filters: date range, status (draft, scheduled, confirmed, in_progress, completed, cancelled), departure, destination. | No |
create_trip | Create a new trip/aircraft reservation with trip type, title, route, dates, times, and aircraft assignment. | Yes |
update_trip | Update an existing trip’s details (title, route, dates, aircraft, status, comments). Idempotent. | Yes |
cancel_trip | Cancel an existing trip with an optional reason. | Yes |
Example: Create a trip
{
"tool": "create_trip",
"arguments": {
"tripType": "charter",
"title": "NYC to Miami charter",
"departureLocation": "KTEB",
"destination": "KOPF",
"departureDate": "2026-04-15",
"departureTime": "08:00"
}
}
Trip Details (Multi-Leg Itineraries)
| Tool | Description | Destructive |
|---|
list_trip_legs | List all legs for a specific trip. | No |
add_trip_leg | Add a new leg to a trip with departure/arrival airports, dates, and times. | Yes |
list_leg_crew | List crew members assigned to a specific flight leg. | No |
assign_crew_to_leg | Assign a crew member to a flight leg with a specified role. | Yes |
remove_crew_from_leg | Remove a crew member from a flight leg. | Yes |
list_leg_passengers | List passengers on a specific flight leg. | No |
add_passenger_to_leg | Add a passenger to a flight leg. | Yes |
remove_passenger_from_leg | Remove a passenger from a flight leg. | Yes |
Airports
| Tool | Description | Destructive |
|---|
search_airports | Search airports by name, city, ICAO code, or location. Returns ICAO/IATA codes, coordinates, elevation, and runway information. | No |
get_airport_details | Get detailed information about a specific airport including facilities, fuel availability, and FBO services. | No |
Availability
| Tool | Description | Destructive |
|---|
check_aircraft_availability | Check whether an aircraft is available on a given date or date range. Returns scheduling conflicts. | No |
check_crew_availability | Check a crew member’s availability and duty time for a given date. | No |
Calendar
| Tool | Description | Destructive |
|---|
get_calendar | Get calendar events (trips, maintenance, certifications) for a date range. | No |
get_crew_schedule | Get a crew member’s schedule for a date range including trips, duty periods, and time off. | No |
Crew and Personnel
| Tool | Description | Destructive |
|---|
list_crew_members | List crew members (pilots, copilots, flight attendants) with filtering by role, status, and certification. | No |
get_crew_member | Get detailed crew member information including certifications, ratings, and contact details. | No |
create_crew_member | Create a new crew member record. | Yes |
Duty and Flight Time
| Tool | Description | Destructive |
|---|
get_duty_time | Get duty time summary for a crew member or the current user. Includes Part 117/135 limits and remaining duty time. | No |
get_flight_hours | Get flight hours summary for a pilot or the current user. Includes rolling 24h/7d/30d/365d totals. | No |
Certifications
| Tool | Description | Destructive |
|---|
list_certifications | List pilot certifications with optional filtering by type (ATP, commercial, instrument, CFI, etc.) or expiry status. | No |
get_certification | Get detailed information about a specific certification including issue/expiry dates and limitations. | No |
Logbook
| Tool | Description | Destructive |
|---|
list_logbook_entries | List flight logbook entries with optional date filtering. | No |
create_logbook_entry | Add a new logbook entry with flight time, route, aircraft, and remarks. | Yes |
Passengers
| Tool | Description | Destructive |
|---|
list_passengers | List passenger manifest with optional search by name. | No |
Safety Management (SMS)
These tools support Flight Risk Assessment Tool (FRAT) scoring and corrective/preventive actions required by FAA 14 CFR Part 5.
| Tool | Description | Destructive |
|---|
list_frat_assessments | List FRAT assessments with filtering by risk level (low, medium, high, critical), date range, and limit. Returns risk summary counts. | No |
create_frat_assessment | Create a new FRAT assessment with five risk dimension scores (weather, pilot experience, aircraft condition, flight complexity, fatigue). Each score 0—10. | Yes |
approve_frat_assessment | Approve a FRAT assessment. Idempotent. | Yes |
create_cpa | Create a corrective/preventive action with title, description, type (corrective/preventive), priority, assignee, due date, and linked report/risk. | Yes |
get_cpa | Get detailed CPA information by ID. | No |
Example: Create a FRAT assessment
{
"tool": "create_frat_assessment",
"arguments": {
"tripId": "trip_abc123",
"weatherScore": 3,
"pilotExperienceScore": 2,
"aircraftConditionScore": 1,
"flightComplexityScore": 4,
"fatigueScore": 2,
"notes": "Night IFR departure from mountainous terrain"
}
}
Safety Reports
| Tool | Description | Destructive |
|---|
list_safety_reports | List SMS safety reports with optional status and date filtering. | No |
get_safety_report | Get detailed safety report by ID, including event description, findings, and linked CPAs. | No |
create_safety_report | Create a new safety report with event type, severity, description, and location. | Yes |
get_safety_dashboard | Get the SMS safety dashboard summary with report counts, trends, and risk indicators. | No |
get_safety_metrics | Get safety performance metrics including SPIs and safety culture indicators. | No |
get_compliance_status | Get current SMS compliance status against 14 CFR Part 5 requirements. | No |
list_investigations | List safety investigations with status and priority filtering. | No |
get_investigation | Get detailed investigation information including findings, root causes, and recommendations. | No |
FBO (Fixed Base Operator)
| Tool | Description | Destructive |
|---|
search_fbos | Search for FBO locations at airports. | No |
create_fbo_service_request | Create a fuel, handling, or catering service request at an FBO. | Yes |
list_fbo_units | List available FBO hangar, ramp, office, or tiedown units. | No |
create_fbo_booking | Create a booking for an FBO unit (hangar, ramp, tiedown, office). | Yes |
check_unit_availability | Check if an FBO unit is available for given dates. | No |
Maintenance
| Tool | Description | Destructive |
|---|
list_maintenance_due | List upcoming maintenance due items for aircraft. Returns items sorted by urgency with remaining time/hours/cycles. | No |
Expenses
| Tool | Description | Destructive |
|---|
list_expenses | List expenses with filtering by category, date range, and trip. | No |
create_expense | Create a new expense record with amount, category, vendor, and optional trip linkage. | Yes |
Weight and Balance
| Tool | Description | Destructive |
|---|
get_weight_balance_profile | Get the weight and balance profile for an aircraft including stations, arms, and moment calculations. | No |
Documents
| Tool | Description | Destructive |
|---|
list_documents | List documents with filtering by type (manual, certificate, SOP, policy) and search. | No |
get_expiring_documents | Get documents expiring within a specified number of days. | No |
get_document | Get detailed document information by ID. | No |
list_passports | List passenger passport/travel document records. | No |
Contracts
| Tool | Description | Destructive |
|---|
list_contracts | List charter contracts and agreements with optional filtering. | No |
get_contract | Get detailed contract information by ID. | No |
list_contract_templates | List available contract templates for creating new contracts. | No |
Reports
| Tool | Description | Destructive |
|---|
list_available_reports | List all available report types (flight, crew, financial, passenger, maintenance). | No |
get_flight_report | Get a flight activity report for a date range. | No |
get_crew_report | Get a crew utilization report for a date range. | No |
get_financial_report | Get a financial summary report for a date range. | No |
export_report | Export a report in a specified format (PDF, CSV, JSON). | No |
AI-Powered Analysis
These tools use AI models for intelligent analysis across operational domains.
| Tool | Description | Destructive |
|---|
assess_flight_risk | AI-powered flight risk assessment that analyzes weather, crew, aircraft, and route factors. | No |
quick_risk_check | Quick risk check with a single-line description. Returns risk level and brief analysis. | No |
extract_invoice_data | Extract structured data from invoice text (vendor, amounts, line items, dates). | No |
query_aviation_document | Query an aviation document with a natural language question. | No |
classify_email | Classify an email by category (booking, maintenance, safety, billing, etc.) and urgency. | No |
draft_email | Draft a professional email given a context, tone, and purpose. | No |
Organization and Settings
| Tool | Description | Destructive |
|---|
get_organization_settings | Get current workspace/organization settings. | No |
get_user_preferences | Get the current user’s preferences (theme, language, notifications). | No |
update_user_preferences | Update user preferences. | Yes |
list_modules | List enabled and available modules for the workspace. | No |
Notifications
| Tool | Description | Destructive |
|---|
list_notifications | List notifications for the current user with optional unread-only filter. | No |
mark_notification_read | Mark a specific notification as read. | Yes |
mark_all_notifications_read | Mark all notifications as read for the current user. | Yes |
get_notification_preferences | Get the current user’s notification channel preferences. | No |
Team and Permissions
| Tool | Description | Destructive |
|---|
list_team_members | List workspace team members for assignment to tasks, CPAs, or trips. | No |
list_permissions | List available permission grants for crew members. | No |
Every tool declares safety annotations that MCP-compatible agents use to make
safe invocation decisions:
| Annotation | Purpose |
|---|
readOnlyHint: true | Tool does not modify any data. Safe to call without user confirmation. |
destructiveHint: true | Tool creates, modifies, or deletes data. Agent should confirm before calling. |
idempotentHint: true | Calling the tool multiple times with the same arguments produces the same result. |
openWorldHint: false | Tool operates only within the PlaneConnection platform — no external side effects. |
Set Up the MCP Server
Configure the MCP server and connect AI agents.
User Roles
Role definitions that determine which tools a user can invoke.
Permissions Matrix
Full feature-by-role permissions matrix.
AI in Aviation Safety
How AI tools support SMS and flight operations.