FlytBase MCP Server

A Model Context Protocol (MCP) server that provides AI assistants like Claude and Cursor with seamless access to FlytBase's comprehensive drone management platform. Control drones, manage missions, analyze flight data, and access media files through natural language interactions.

Installation

npm install -g @flytbase/mcp-server

Quick Start

1. Get your FlytBase bearer token from your FlytBase account
2. Configure the server using environment variables or CLI options
3. Add to your AI assistant configuration

Using with Claude Desktop

Add to your Claude Desktop configuration file:

{
  "mcpServers": {
    "flytbase": {
      "command": "flytbase-mcp",
      "args": ["start"],
      "env": {
        "FLYTBASE_BEARER_TOKEN": "your_bearer_token_here",
        "FLYTBASE_ORG_ID": "your_organization_id_here"
      }
    }
  }
}

Using with Cursor

Add to your Cursor MCP configuration:

{
  "mcpServers": {
    "flytbase": {
      "command": "npx",
      "args": ["@flytbase/mcp-server", "start", "--env", "development", "--token", "your_bearer_token_here"]
    }
  }
}

Configuration

Environment Variables

• FLYTBASE_BEARER_TOKEN (required): Your FlytBase API bearer token
• FLYTBASE_ORG_ID (required): Your FlytBase organization ID
• FLYTBASE_API_URL (optional): Override the API base URL

API Environments

The server automatically connects to the production FlytBase API (https://api.flytbase.com) by default, ensuring secure and reliable access to your live drone operations.

Usage

Command Line Interface

# Start the server
flytbase-mcp start --token your_token_here

# Show current configuration
flytbase-mcp config

Environment File

Create a .env file:

FLYTBASE_BEARER_TOKEN=your_bearer_token_here
FLYTBASE_ORG_ID=your_organization_id_here

Then start the server:

flytbase-mcp start

Available Resources

The MCP server provides access to the following FlytBase resources:

• 🚁 Flight Missions: Create, schedule, and manage autonomous drone missions with waypoints
• 📱 Drone Devices: Monitor connected drones, docks, and their real-time status
• 📊 Flight Logs: Access comprehensive historical flight data, telemetry, and analytics
• 📸 Media Files: Retrieve photos, videos, and documents captured during flights
• 🗓️ Mission Scheduling: Configure recurring missions and manage flight automation
• 📍 Sites & Locations: Handle operational sites and geographic boundaries

Key Features

• 🤖 Natural Language Interface: Control drones using conversational AI
• 🔄 Real-time Data: Access live drone status, battery levels, and GPS positions
• 📈 Advanced Analytics: Generate flight reports and operational insights
• 🛡️ Secure Access: Enterprise-grade authentication and permissions
• 🌐 Multi-Environment: Support for development, staging, and production
• 📱 Cross-Platform: Works with Claude Desktop, Cursor, and other MCP clients

Available Tools

Device Management

• list_devices: List all drone and dock devices in your organization
• check_device_exists: Verify if a specific device exists
• update_device_name: Update the display name of devices
• delete_devices: Remove devices from your organization
• get_pending_registrations: View pending device registration requests

Flight Data & Analytics

• get_flight_logs: Retrieve historical flight logs with filtering and pagination
• get_all_flight_logs_batched: Retrieve ALL flight logs by automatically fetching in batches
• get_flight_log: Get comprehensive details about specific flights
• get_flight_telemetry: Access GPS coordinates and telemetry data for flight paths
• archive_flights: Archive flight logs for long-term storage

Mission Scheduling

• get_scheduled_missions: Retrieve all scheduled and recurring missions within a time range
• create_scheduled_mission: Schedule missions for one-time or recurring execution
• update_scheduled_mission: Modify existing scheduled missions
• delete_scheduled_mission: Permanently delete scheduled missions
• uncancel_scheduled_mission_exception: Restore a cancelled mission occurrence
• delete_scheduled_mission_exception: Delete a specific exception from a scheduled mission

Media Management

• search_media: Find photos, videos, and documents captured during flights
• get_media_metadata: Get detailed metadata for specific media files
• export_media_files: Create downloadable ZIP archives of media files
• get_media_statistics: Access storage analytics and media usage reports

Stream Analytics

• get_all_organizations_streaming_usage: Get comprehensive streaming usage across all organizations
• get_organization_monthly_streaming_usage: Get monthly streaming usage for specific organization
• get_organization_device_wise_streaming_usage: Get device-wise streaming breakdown for organization
• get_organization_platform_streaming_usage: Get platform-wise streaming usage (Agora, MediaMTX, etc.)
• get_organization_vvm_breakdown: Get detailed VVM breakdown by role and screen type

Example Usage with AI Assistants

Once configured, you can interact with your AI assistant using natural language:

Device Operations

"List all my drones and their current status"
"What devices are registered in my organization?"
"Show me the battery level and location of drone M3D"
"Are there any pending device registrations?"

Mission Scheduling

"Schedule a daily inspection mission for the warehouse at 9 AM"
"Show me all scheduled missions for this week"
"Delete the scheduled mission for next Friday"
"Update the mission schedule to start at 10 AM instead"
"Cancel the exception for the missed flight on Monday"

Flight Analysis & Reporting

"Show me flight logs from the last 7 days"
"What was the flight path for mission ABC123?"
"Get telemetry data for the most recent M3D flight"
"How many flights were completed yesterday?"

Media & Documentation

"Find all photos captured during today's flights"
"Show me videos from the Alpha Site location"
"Get download links for media from flight XYZ789"
"What's the total storage usage for this month?"

Stream Analytics & Usage Monitoring

"Show me streaming usage across all organizations"
"Get monthly streaming usage for organization ABC123"
"Which devices are using the most streaming minutes?"
"Show me platform-wise streaming usage breakdown"
"Get VVM breakdown by user roles for this month"

Getting Your Credentials

Bearer Token

1. Log into your FlytBase account
2. Navigate to API Settings or Developer Console
3. Generate a new API token with appropriate permissions
4. Copy the bearer token for use with this MCP server

Organization ID

1. In your FlytBase dashboard, go to Organization Settings
2. Copy your Organization ID from the account details
3. Use this ID in the FLYTBASE_ORG_ID environment variable

Troubleshooting

Common Issues

"Bearer token is required" error:

• Ensure FLYTBASE_BEARER_TOKEN environment variable is set
• Verify the token is valid and not expired

"Connection failed" error:

• Check your internet connection
• Verify the API base URL is correct for your environment
• Ensure the bearer token has proper permissions

"Resource not found" error:

• Verify your organization ID is correct
• Check that you have access to the requested resources

Debug Mode

Enable debug logging:

FLYTBASE_ENV=development flytbase-mcp start

Configuration Check

Verify your configuration:

flytbase-mcp config

Development

Building from Source

# Clone the repository
git clone https://github.com/flytbase/flytbase-web-mono-repo.git
cd flytbase-web-mono-repo/flytbase-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

# Start development server
npm run dev

Project Structure

flytbase-mcp-server/
├── src/
│   ├── modules/           # Feature modules
│   │   ├── devices/       # Device management
│   │   ├── flight_logs/   # Flight data & analytics
│   │   ├── media/         # Media file operations
│   │   ├── missions/      # Mission management
│   │   └── mission_scheduler/ # Scheduling operations
│   ├── tools/            # MCP tool definitions
│   ├── config.ts         # Environment configuration
│   ├── flytbase-client.ts # API client
│   └── mcp-server.ts     # Main MCP server
├── configs/              # Environment configs
└── package.json

Testing

# Run all tests
npm test

# Run with coverage
npm run test:coverage

# Test specific module
npm test -- --grep "devices"

Changelog

v1.2.1

• Removed: get_device_monthly_streaming_usage tool due to consistent 404 errors (no device-level streaming data available)
• Improved: Streamlined streaming analytics tools to focus on organization-level insights

v1.2.0

• Added comprehensive streaming analytics and VVM breakdown tools
• Enhanced device management capabilities
• Improved error handling and logging

Support

• 📧 Email: [email protected]
• 📖 Documentation: https://docs.flytbase.com
• 🐛 Issues: https://github.com/flytbase/flytbase-mcp-server/issues

License

MIT License - see LICENSE file for details.

FlytBase MCP Server - Bringing AI-powered drone operations to your fingertips.