> ## Documentation Index
> Fetch the complete documentation index at: https://docs.planeconnection.com/llms.txt
> Use this file to discover all available pages before exploring further.
# MCP Server Tool Catalog
> Complete reference for PlaneConnection's Model Context Protocol (MCP) server — 88 aviation tools across 26 domain modules for AI agent integration.
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](/en/how-to/admin/set-up-mcp).
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
```json theme={}
{
"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
```json theme={}
{
"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
```json theme={}
{
"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 |
## Tool Annotations
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. |
## Related
Configure the MCP server and connect AI agents.
Role definitions that determine which tools a user can invoke.
Full feature-by-role permissions matrix.
How AI tools support SMS and flight operations.