Fly.io
Arcade tools designed for LLMs to interact with Fly.io
1.0.1Fly.io Toolkit
Arcade toolkit for interacting with Fly.io, enabling LLMs to manage the full lifecycle of Fly.io apps, machines, volumes, networking, and secrets programmatically.
Capabilities
- App & release management: list, inspect, and deploy apps; roll out new container images; browse release history; and scale VM size or machine count across an organization.
- Machine lifecycle: create, start, stop, restart, and permanently destroy individual Machines; inspect configuration, state, and health.
- Volumes: create, extend, list, and destroy persistent volumes attached to apps.
- Networking & TLS: allocate and release dedicated IP addresses; add, check, and remove custom-domain TLS certificates; retrieve required DNS records.
- Secrets management: list secret names, set new secrets, and unset existing secrets on an app, with optional immediate rollout; secret values are never returned by Fly.io.
- Observability & org context: read recent app logs (requires a log-read–scoped token; returns a
no_accessstatus rather than raising when access is missing); list organizations, available regions, and per-app IP addresses.
Secrets
FLYIO_ACCESS_TOKEN — A Fly.io personal access token or deploy token used to authenticate all API requests. To create one, log in to the Fly.io dashboard and generate a new token under Account → Access Tokens. Alternatively, use the Fly CLI: fly tokens create deploy -a <app-name> for a deploy-scoped token or fly auth token to retrieve your current personal token. Note that reading logs (Flyio.GetLogs) requires the token to have log-read access; a standard deploy token lacks this permission, so use a personal access token or one explicitly granted log-read scope if log access is needed. See the Fly.io token documentation for details on token types and scopes.
Configure this secret in Arcade at https://docs.arcade.dev/en/guides/create-tools/tool-basics/create-tool-secrets or via the dashboard at https://api.arcade.dev/dashboard/auth/secrets.
Available tools(30)
| Tool name | Description | Secrets | |
|---|---|---|---|
Add a TLS certificate for a hostname and return the DNS records to set. | 1 | ||
Allocate a new IP address for an app. | 1 | ||
Check a certificate's validation status and any pending DNS records. | 1 | ||
Create a new Machine for an app from a container image. | 1 | ||
Create a new persistent volume for an app. | 1 | ||
Roll a new container image out to all of an app's Machines. | 1 | ||
Permanently destroy a Machine. Stop it first unless force is set. | 1 | ||
Permanently destroy a volume and the data it holds. | 1 | ||
Grow a volume to a larger size. Volumes cannot be shrunk. | 1 | ||
Get the current status of a single Fly.io app. | 1 | ||
Read recent historical log entries for an app, optionally filtered.
Reading logs requires a token granted log-read access, which is a capability
separate from app management; a token without it cannot read logs at all. When
that access is missing this returns a ``no_access`` result rather than raising,
so prefer branching on the result's ``status`` over assuming logs are present. | 1 | ||
Get the configuration, state, and health of a single Machine. | 1 | ||
List Fly.io apps, optionally scoped to a single organization.
Apps are returned in Fly.io's own ordering, with pagination metadata so a
caller can tell when more apps exist beyond the returned window. | 1 | ||
List the custom-domain TLS certificates configured on an app. | 1 | ||
List the IP addresses assigned to an app, including the shared IPv4. | 1 | ||
List the Machines that belong to an app. | 1 | ||
List the Fly.io organizations the configured token can access. | 1 | ||
List the Fly.io regions available for deploying apps and volumes. | 1 | ||
List an app's release history, newest first. | 1 | ||
List an app's secret names. Secret values are never returned by Fly.io. | 1 | ||
List the persistent volumes that belong to an app. | 1 | ||
Release a dedicated IP address so it is no longer assigned to the app. | 1 | ||
Remove a custom-domain TLS certificate from an app. | 1 | ||
Restart a Machine and report its settled state. | 1 | ||
Scale an app to a target Machine count by adding or removing Machines. | 1 |