Fly Integration for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Fly MCP or direct API to deploy apps, monitor micro-VMs, view region status, and manage scaling through natural language.
GET STARTED FOR FREE
Fly Logo
Gradient Top
Gradient Middle
Gradient Bottom
divider

Try Fly now

Enter a prompt below to test the integration in our Tool Router playground. You'll be redirected to sign in and try it live.

Supported Tools

Tools
Add WireGuard PeerTool to add a WireGuard peer connection to a Fly.
Check App Name AvailabilityTool to validate an app name for Fly.
Check JobsExecute GraphQL queries against the Fly.
Check User Only TokenCheck whether the authentication token only allows user access.
Create Health Check JobTool to create a health check job for monitoring application endpoints in Fly.
Create Check Job RunTriggers a run of an existing health check job on Fly.
Create Delegated WireGuard TokenTool to create a delegated WireGuard token for peer management in a Fly.
Create Third-Party ConfigurationTool to create a third-party service configuration for discharging macaroon caveats.
Delete Delegated WireGuard TokenTool to delete a delegated WireGuard token from a Fly.
Delete OrganizationTool to delete a Fly.
Delete Remote BuilderTool to delete a remote builder configuration for a Fly.
Delete Third Party ConfigurationTool to delete a third-party service configuration from Fly.
Detach Postgres ClusterTool to detach a Postgres cluster from a Fly.
Establish SSH KeyTool to establish an SSH key for a Fly.
Fetch Nodes by IDsFetches a list of node objects from Fly.
Get Add-OnTool to find a Fly.
Get Add-On ProviderTool to query information about a specific Fly.
Get app detailsTool to retrieve detailed information about a specific Fly.
Get CertificateTool to retrieve a certificate by its ID from Fly.
Get Current Token InfoTool to get information about the current authentication token.
Get Latest Image DetailsTool to retrieve the latest available tag details for a given image repository from Fly.
Get Latest Image TagTool to retrieve the latest available image tag for a Fly.
Get MachineTool to get a single machine by ID from Fly.
Get Nearest RegionTool to retrieve the nearest Fly.
Get Node by IDTool to fetch an object by its globally unique ID using Fly.
Get OrganizationTool to find a Fly.
Get Personal OrganizationTool to retrieve the user's personal organization details from Fly.
Get PlacementsTool to get placement recommendations for Machines in Fly.
Get Platform InformationTool to retrieve Fly.
Get Products and PricingTool to retrieve Fly.
Get RegionsTool to get the list of available Fly.
Get Viewer InfoTool to retrieve the authenticated user's account information from Fly.
Issue CertificateTool to issue an SSH certificate for accessing Fly.
List Add-On PlansTool to list available add-on service plans from Fly.
List Add-OnsTool to list add-ons associated with an organization in Fly.
List AppsTool to list all Fly Apps in an organization.
List Apps via GraphQLList all Fly.
Check LocationsRetrieve all available Fly.
List MachinesTool to list Fly.
List Organization MachinesTool to list all Machines across all apps in a Fly organization.
Remove WireGuard PeerTool to remove a WireGuard peer connection from a Fly.
Set Apps V2 DefaultTool to configure whether new apps in an organization use Apps V2 by default on Fly.
Update Third-Party ConfigurationTool to update an existing third-party service configuration for discharging macaroon caveats.
Validate ConfigTool to validate a Fly.
Validate WireGuard PeersTool to validate WireGuard peer IP addresses in a Fly.
Python
TypeScript

Install Composio

python
pip install composio claude-agent-sdk
Install the Composio SDK for Python or TypeScript

Initialize Client and Create Tool Router Session

python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
Import and initialize the Composio client, then create a Tool Router session for Fly

Connect to AI Agent

python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Fly tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('List all running apps on Fly and show their regions')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
Use the MCP server with your AI agent (Anthropic Claude or Mastra)

Why Use Composio?

AI Native Fly Integration

  • Supports both Fly MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Fly data

Managed Auth

  • Built-in OAuth handling with automatic token refresh and rotation
  • Central place to manage, scope, and revoke Fly access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Fly
  • Scoped, least privilege access to Fly resources
  • Full audit trail of agent actions to support review and compliance

Use Fly with any AI Agent Framework

Choose a Framework you want to connect Fly with

Frequently Asked Questions

Do I need my own developer credentials to use Fly with Composio?

Yes, Fly requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Used by agents from

Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai

Never worry about agent reliability

We handle tool reliability, observability, and security so you never have to second-guess an agent action.

Book a call↗Get started for free