45 available actions

What your AI agent can do in Fly

Fly.io transforms containers into micro-VMs that run on hardware in 30+ regions on six continents. This page lists every available action. Your agent only receives the actions and permissions required for the role you approve.

Common starting points

  • Get Add-OnTool to find a Fly.io add-on by ID, name, or provider.
  • Get Add-On ProviderTool to query information about a specific Fly.io add-on provider (extension) by name.
  • Create Health Check JobTool to create a health check job for monitoring application endpoints in Fly.io.
  • Create Check Job RunTriggers a run of an existing health check job on Fly.io.
  • Update Third-Party ConfigurationTool to update an existing third-party service configuration for discharging macaroon caveats.
  • Set Apps V2 DefaultTool to configure whether new apps in an organization use Apps V2 by default on Fly.io.

Browse all 45 actions by capability

Open a capability to see every supported action and its description.

Find & reviewLook up and review existing recordsView 28 actionsHide actions
  • Check App Name AvailabilityTool to validate an app name for Fly.io app creation.
  • Check JobsExecute GraphQL queries against the Fly.io checkJobs endpoint.
  • Check User Only TokenCheck whether the authentication token only allows user access.
  • Fetch Nodes by IDsFetches a list of node objects from Fly.io given a list of IDs using the GraphQL nodes query.
  • Get Add-OnTool to find a Fly.io add-on by ID, name, or provider.
  • Get Add-On ProviderTool to query information about a specific Fly.io add-on provider (extension) by name.
  • Get app detailsTool to retrieve detailed information about a specific Fly.io application.
  • Get CertificateTool to retrieve a certificate by its ID from Fly.io.
  • 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.io's registry.
  • Get Latest Image TagTool to retrieve the latest available image tag for a Fly.io Docker repository.
  • Get MachineTool to get a single machine by ID from Fly.io.
  • Get Nearest RegionTool to retrieve the nearest Fly.io region to the requesting client based on network location.
  • Get Node by IDTool to fetch an object by its globally unique ID using Fly.io's GraphQL node query.
  • Get OrganizationTool to find a Fly.io organization by slug using the GraphQL API.
  • Get Personal OrganizationTool to retrieve the user's personal organization details from Fly.io.
  • Get PlacementsTool to get placement recommendations for Machines in Fly.io regions.
  • Get Platform InformationTool to retrieve Fly.io platform information including available regions, VM sizes, and flyctl version.
  • Get Products and PricingTool to retrieve Fly.io product and price information via GraphQL.
  • Get RegionsTool to get the list of available Fly.io regions with optional filtering.
  • Get Viewer InfoTool to retrieve the authenticated user's account information from Fly.io.
  • List Add-On PlansTool to list available add-on service plans from Fly.io.
  • List Add-OnsTool to list add-ons associated with an organization in Fly.io.
  • List AppsTool to list all Fly Apps in an organization.
  • List Apps via GraphQLList all Fly.io applications with details including volumes, services, and VMs using GraphQL.
  • Check LocationsRetrieve all available Fly.io health check locations.
  • List MachinesTool to list Fly.io machines using GraphQL API with pagination support.
  • List Organization MachinesTool to list all Machines across all apps in a Fly organization.
Create & communicateCreate records or send supported messagesView 5 actionsHide actions
  • Add WireGuard PeerTool to add a WireGuard peer connection to a Fly.io organization for private network access.
  • Create Health Check JobTool to create a health check job for monitoring application endpoints in Fly.io.
  • Create Check Job RunTriggers a run of an existing health check job on Fly.io.
  • Create Delegated WireGuard TokenTool to create a delegated WireGuard token for peer management in a Fly.io organization.
  • Create Third-Party ConfigurationTool to create a third-party service configuration for discharging macaroon caveats.
Update & manageChange and manage existing recordsView 2 actionsHide actions
  • Set Apps V2 DefaultTool to configure whether new apps in an organization use Apps V2 by default on Fly.io.
  • Update Third-Party ConfigurationTool to update an existing third-party service configuration for discharging macaroon caveats.
Remove & cancelRemove records or cancel supported workView 5 actionsHide actions
  • Delete Delegated WireGuard TokenTool to delete a delegated WireGuard token from a Fly.io organization.
  • Delete OrganizationTool to delete a Fly.io organization and all its associated resources using the GraphQL API.
  • Delete Remote BuilderTool to delete a remote builder configuration for a Fly.io organization.
  • Delete Third Party ConfigurationTool to delete a third-party service configuration from Fly.io.
  • Remove WireGuard PeerTool to remove a WireGuard peer connection from a Fly.io organization.
Other actionsSpecialist and administrative actions.View 5 actionsHide actions
  • Detach Postgres ClusterTool to detach a Postgres cluster from a Fly.io application, revoking access credentials.
  • Establish SSH KeyTool to establish an SSH key for a Fly.io organization.
  • Issue CertificateTool to issue an SSH certificate for accessing Fly.io infrastructure.
  • Validate ConfigTool to validate a Fly.io app configuration.
  • Validate WireGuard PeersTool to validate WireGuard peer IP addresses in a Fly.io organization.

Connection record

A connection you can control.

Sign-in
Customer-managed key
Setup
Use a key you create and control. It is stored securely and limited to the work agreed for the role.
Boundaries
Only the approved role and actions.
Off switch
Revoke the connection from your account.

FAQ

Before you connect Fly

How does the agent connect to Fly?
With a key you create and control. It is stored securely, permissions are limited to what the agent needs, and you can revoke it at any time.
What can the agent actually do in Fly?
The page above lists the 45 actions currently available through the Fly connection. The role determines which of those actions the agent may use, and write access is only enabled when the workflow needs it.
Is Fly included in my plan?
Connections are priced per tool on top of the base plan. Some are included and some are premium. See pricing for how connection charges work.
How long until Fly is ready?
Timing depends on the sign-in method, permissions and workflow being connected. We confirm the scope and setup plan before enabling the connection.

Bring the workflow together

Ready to put Fly to work?

Start with the responsibility you want off your plate. We’ll map the connection and the boundaries around it.

All product names, logos, and brands are property of their respective owners and are used for identification only. ZeroToClaw is not affiliated with or endorsed by Fly.