Flight Control

The MCP server lets you query and retrieve contextual information about devices and fleets managed by Flight Control through a safe, authenticated REST API. It enables external integrations, reporting, and automation by offering read-only access to data such as devices, fleets, events, enrollment requests, repositories, and resource syncs.

How to use

You connect to the MCP server with a client that supports the streamable-http transport or the traditional stdio flow. Use the streamable-http transport to expose the MCP API over HTTP in web deployments, or use the stdio flow for local tooling and script integrations.

How to install

Prerequisites: you need Podman or Docker installed to run the MCP image locally, and you should have a client capable of speaking MCP endpoints (HTTP or stdio). If you prefer the pre-built image, you can pull and run it directly.

# Optional: build from source locally
podman build -t mcp-server:latest .

# Run the pre-built image with the recommended streamable-http transport
podman run -p 8000:8000 \
  -v ~/.config/flightctl:/root/.config/flightctl:ro \
  -e MCP_TRANSPORT=streamable-http \
  -e MCP_HOST=0.0.0.0 \
  -e MCP_PORT=8000 \
  quay.io/flightctl/flightctl-mcp:latest

Additional content

Configuration and transport options are provided to help you tailor the MCP server to your environment. You can use either HTTP-based streaming or the stdio transport for local workflows. The server authenticates using OIDC/OAuth2 refresh tokens and supports SSL certificate handling with options for custom CA certificates or skipping verification in development.

Available tools

query_devices

Query and filter devices using labels and field selectors to retrieve matching devices.

run_command_on_device

Execute Linux commands on specific devices, enabling remote command execution.

query_fleets

Query and filter fleet configurations to retrieve matching fleets.

query_events

Query system events and audit logs for monitoring and analysis.

query_enrollment_requests

Query device enrollment requests to monitor onboarding.

query_repositories

Query configuration repositories for their metadata and status.

query_resource_syncs

Query resource synchronization status across managed resources.