checkpoint_create
ChatGPTCreate a new checkpoint of the current sprite state. Returns streaming NDJSON progress.
checkpoint_get
ChatGPTGet details of a specific checkpoint.
checkpoint_list
ChatGPTList all checkpoints.
checkpoint_restore
ChatGPTRestore to a specific checkpoint. Returns streaming NDJSON progress.
cordon_machine
ChatGPTRemove this Machine from proxy routing; existing application work can continue. Requires explicit fly:machines:write authorization.
create_machine
ChatGPTCreate a billable Machine from explicit configuration. It starts unless skip_launch is set. If the response is lost, inspect existing Machines before retrying; mutations are not automatically retried. Requires explicit fly:machines:write authorization.
create_machine_lease
ChatGPTAcquire a temporary Machine lease, or renew it with the existing lease_nonce. Keep the returned nonce private; use it for subsequent mutations and release. Requires explicit fly:machines:write authorization.
create_postgres_backup
ChatGPTCreate a backup for a specific cluster. The backup runs asynchronously and is rejected if one is already in progress.
create_postgres_cluster
ChatGPTCreate a Managed Postgres cluster in the organization. Provisioning is asynchronous: poll get_postgres_cluster until its status is ready before creating databases or enabling extensions.
create_postgres_database
ChatGPTCreate a database within a specific cluster.
create_sprite
ChatGPTCreate a Sprite within this connection's grant restrictions. First call get_fly_context and inspect the Sprites binding restrictions for the required name_prefix and max_sprites_total creation limit.
create_volume
ChatGPTCreate a new billable persistent volume. Restoring or forking another volume is not supported by this tool; those operations require separate source-resource authorization. Requires explicit fly:volumes:write authorization.
create_volume_snapshot
ChatGPTSchedule a volume snapshot. The volume must be attached and ready. Creation is asynchronous and may not return a snapshot ID; use list_volume_snapshots afterward to find the snapshot ID and completion status. Requires explicit fly:volumes:write authorization.
delete_app
ChatGPTPermanently delete the app. This can disrupt or delete its resources; inspect the app first. Requires explicit fly:apps:delete authorization.
delete_app_secret
ChatGPTDelete an app secret. Repeated deletion of an absent name can still succeed and advance the secrets version. Requires explicit fly:secrets:delete authorization.
delete_machine
ChatGPTPermanently destroy the Machine and its ephemeral root filesystem. Attached volumes are separate resources. force is never enabled implicitly. Requires explicit fly:machines:delete authorization.
delete_machine_metadata_key
ChatGPTRemove one metadata key from the named Machine, leaving other keys unchanged. Requires explicit fly:machines:write authorization.
delete_volume
ChatGPTPermanently destroy a persistent volume and its data. Detach it from Machines before deletion. Requires explicit fly:volumes:delete authorization.
destroy_sprite
ChatGPTDestroy a sprite in the authenticated organization.
enable_postgres_extension
ChatGPTEnable a Postgres extension within a specific database. PostGIS extensions require a PostGIS-enabled cluster.
exec
ChatGPTRun a command on the named Sprite without a TTY and return its output; interactive commands that need a terminal are not supported. Pass an argv array to preserve argument boundaries; to use shell syntax, explicitly run a shell such as bash -c. Commands can modify files and access the network.
exec_kill
ChatGPTKill an exec session by session ID. Returns streaming NDJSON with kill progress.
exec_list
ChatGPTList active exec sessions.
exec_machine_command
ChatGPTExecute an explicit argv array on the Machine, without an implicit shell. Can read or change application data. Command output may contain sensitive values. Requires explicit fly:machines:exec authorization.
extend_volume
ChatGPTIncrease the named persistent volume to size_gb GiB total, not by that amount. This permanently increases capacity and associated storage charges; volumes cannot be shrunk. Read get_volume first. Only call when the user has authorized the target volume and new total size. Requires explicit fly:volumes:write authorization.
file_copy
ChatGPTCopy a file or directory on the named Sprite. recursive, preserveAttrs and asRoot default to false; enable them explicitly to copy directory trees, preserve attributes or use root privileges.
file_delete
ChatGPTDelete a file or directory on the named Sprite. recursive defaults to false; set it to true explicitly to delete a directory tree. asRoot defaults to false.
file_list
ChatGPTList directory contents.
file_read
ChatGPTRead file contents from the sprite filesystem. Returns raw file bytes.
file_rename
ChatGPTRename or move a file or directory on the named Sprite. asRoot defaults to false.
file_write
ChatGPTWrite up to 16 MiB of file contents to the sprite filesystem. Request body contains raw file bytes.
fork_postgres_cluster
ChatGPTFork a ready Managed Postgres cluster into a new cluster that inherits the source's settings, on the source's plan unless plan is given. The source cluster is left unchanged, and the fork is provisioned asynchronously.
get_app
ChatGPTRead an app's identity, organization, status, and counts.
get_app_certificate
ChatGPTRead TLS certificate details and validation status for one hostname on the named app. Requires explicit fly:certificates:read authorization.
get_app_secret
ChatGPTRead one secret's name, digest and timestamps. Its value is never returned. Requires explicit fly:secrets:read authorization.
get_credit_balance
ChatGPTRead the selected organization's purchased credit balance in US cents, the Purchased Credit Balance on its billing page. Trial credits and other grants are not included. For an organization billed through a parent organization, purchased_credit_balance_cents is null and billed_by_parent is true. Does not buy credits or alter payment settings.
get_fly_context
ChatGPTShow this connection's current authorized resource bindings, per-resource scopes, and restrictions, including the Sprites name_prefix and max_sprites_total creation limit. This describes the grant and never expands access.
get_launch_requirements
ChatGPTExplain launch blockers and return browser handoffs for billing, SSO or provider terms. Does not accept terms or alter payment settings.
get_machine
ChatGPTRead a Machine's identity and lifecycle summary. Excludes configuration and secrets.
get_machine_configuration
ChatGPTRead the full Machine configuration under explicit authorization. Configuration can contain sensitive environment, file and metadata values. Requires explicit fly:machines:sensitive:read authorization.
get_machine_lease
ChatGPTRead the active lease under an explicit management grant. Lease nonces are sensitive concurrency credentials. Requires explicit fly:machines:write authorization.
get_machine_memory
ChatGPTRead the named Machine's current memory limit and available memory in MiB. Requires explicit fly:machines:write authorization.
get_machine_metadata
ChatGPTRead arbitrary Machine metadata under explicit authorization; values can be sensitive. Requires explicit fly:machines:sensitive:read authorization.
get_machine_metadata_key
ChatGPTRead one arbitrary Machine metadata value under explicit authorization. Requires explicit fly:machines:sensitive:read authorization.
get_organization
ChatGPTRead the selected organization's identity, current role and launch eligibility.
get_postgres_cluster
ChatGPTGet details of a specific Managed Postgres cluster, including its status and, once it is ready, its endpoints.
get_postgres_plans
ChatGPTList the Managed Postgres plans available when creating or forking a cluster in an organization, cheapest first.
get_sprite_info
ChatGPTRead authorized Sprite metadata without waking it. Pass sprite_id from a mention or Inspector selection to reject deleted and recreated environments.
get_volume
ChatGPTRead the named persistent volume's size, region, attachment and snapshot settings. Use this to inspect the target before updating, extending or deleting it. Requires explicit fly:volumes:read authorization.
list_app_certificates
ChatGPTList TLS certificates configured for the named app, including hostnames and certificate status. Requires explicit fly:certificates:read authorization.
list_app_ips
ChatGPTList the named app's assigned IP addresses and their types for inspecting public and private networking. Requires explicit fly:network:read authorization.
list_app_secrets
ChatGPTList secret names, digests and timestamps. Secret values are never returned. Requires explicit fly:secrets:read authorization.
list_apps
ChatGPTList app identity, organization, status, and counts.
list_machine_events
ChatGPTList lifecycle events for the named Machine, including state transitions and their timestamps, to investigate starts, stops and failures. Requires explicit fly:machines:read authorization.
list_machine_processes
ChatGPTRead process details, which can include sensitive command arguments, under explicit authorization. Requires explicit fly:machines:sensitive:read authorization.
list_machine_versions
ChatGPTRead historical Machine configurations under explicit authorization. History can contain sensitive environment, file and metadata values. Requires explicit fly:machines:sensitive:read authorization.
list_machines
ChatGPTList Machine identity and lifecycle summaries for an app. Excludes configuration and secrets.
list_organizations
ChatGPTList current organization identities and roles under explicitly granted account-directory access. This does not authorize their resources.
list_postgres_active_queries
ChatGPTList active queries in the supplied database. Returns full query text and durations in seconds.
list_postgres_backups
ChatGPTList all backups associated with a specific cluster.
list_postgres_clusters
ChatGPTList Managed Postgres clusters for an organization.
list_postgres_databases
ChatGPTList all databases within a specific cluster.
list_postgres_extensions
ChatGPTList all extensions available within a specific database, indicating which are installed.
list_postgres_slow_queries
ChatGPTList the top 20 queries by cumulative total execution time, excluding the postgres database. Uses the latest available metrics within the lookback range; statistics are cumulative PostgreSQL counters, not deltas over that range. Returns full query text and execution times in seconds.
list_postgres_users
ChatGPTList all Postgres users within a specific cluster.
list_sprites
ChatGPTList Sprites visible to this connection. The grant's name prefix and optional label filter access; this is not necessarily every Sprite in the organization, nor limited to Sprites created by this client. Call get_fly_context to inspect the restrictions.
list_volume_snapshots
ChatGPTList snapshots for the named volume, including snapshot IDs, creation times and status. Use this after create_volume_snapshot to check asynchronous snapshot creation. Requires explicit fly:volumes:read authorization.
list_volumes
ChatGPTList volumes, hiding deletion-state volumes by default. Set include_destroyed=true to include them. With summary=true, byte and block statistics are unavailable and omitted. Requires explicit fly:volumes:read authorization.
open_sprite_inspector
ChatGPTOpen a read-only Sprite Inspector showing environments, services, checkpoints and recent service logs. Opening only lists metadata; runtime reads are explicit and may wake a Sprite.
policy_network_get
ChatGPTRead the named Sprite's current network policy rules before preparing a replacement.
policy_network_update
ChatGPTReplace the named Sprite's entire network policy with the supplied rules; this does not append rules. Read policy_network_get first and include every rule to retain. Replacement can interrupt network access and running work.
reclaim_machine_memory
ChatGPTRequest reclamation of amount_mb MiB from the named Machine. Returns the actual amount reclaimed; reclamation can affect running workload performance. Requires explicit fly:machines:write authorization.
release_machine_lease
ChatGPTRelease the Machine lease using its exact lease_nonce. Requires explicit fly:machines:write authorization.
restart_machine
ChatGPTRestart the Machine and interrupt its running work. Requires explicit fly:machines:write authorization.
search_sprite_mentions
ChatGPTFind up to 20 authorized Sprites by name prefix for composer mentions.
service_create
ChatGPTRegister a named service on the Sprite. On provider-backed Sprites, creates or replaces the stored service definition; use service_start and service_logs for explicit runtime control and output. On legacy Sprites, a new service starts with its dependencies and streams initial logs (duration defaults to 5s). An existing legacy service with the same cmd succeeds without changing any settings; a different cmd conflicts. Read service_get before reusing a name and verify the definition afterward.
service_get
ChatGPTGet details of a specific service.
service_list
ChatGPTList all configured services and their current state.
service_logs
ChatGPTStream logs for a service.
service_start
ChatGPTStart a service. Returns streaming NDJSON with stdout/stderr.
service_stop
ChatGPTStop a running service. Returns streaming NDJSON with service stop progress.
set_app_secret
ChatGPTSet a secret value. The result contains metadata only; secret values are not echoed. Requires explicit fly:secrets:write authorization.
set_machine_memory_limit
ChatGPTSet the named Machine's memory limit to limit_mb MiB. Lowering the limit can cause memory pressure or out-of-memory failures in running workloads. Requires explicit fly:machines:write authorization.
set_machine_metadata_key
ChatGPTCreate or replace the value of one metadata key on the named Machine, leaving other keys unchanged. Requires explicit fly:machines:write authorization.
signal_machine
ChatGPTSend a Unix signal to the running Machine's main process. SIGTERM requests termination and allows application cleanup if handled; SIGINT requests an interrupt. SIGKILL terminates immediately without cleanup and can lose in-flight work. SIGHUP, SIGUSR1 and SIGUSR2 have application-defined behavior; choose the signal explicitly. Requires explicit fly:machines:write authorization.
start_machine
ChatGPTStart a stopped or suspended Machine using its existing configuration. Use wait_for_machine_state with state started to wait for startup. Requires explicit fly:machines:write authorization.
stop_machine
ChatGPTStop running work on the Machine. Existing auto_destroy configuration still applies. Requires explicit fly:machines:write authorization.
submit_feedback
ChatGPTSend the Fly.io team a report about a Fly.io platform bug, a documentation problem or a missing feature you hit while working. Cite what it is about with request_id, url or tool. Reporting the same request_id again returns the original report. Fly.io staff read every report but don't reply to them. If the user needs help with their apps, account or billing, send them to https://docs.fly.io/about/support and don't tell them they've contacted support. Do not report errors in the user's own application, and never include secrets, tokens, credentials or customer data.
suspend_machine
ChatGPTSuspend running work on the Machine; this interrupts service until resumed. Requires explicit fly:machines:write authorization.
uncordon_machine
ChatGPTAllow proxy routing to this Machine again. Requires explicit fly:machines:write authorization.
update_app_secrets
ChatGPTSet or remove several secrets. Null values remove secrets and additionally require fly:secrets:delete consent. The upstream bulk API requires create, write and delete action bits even for sets; secret values are never echoed. Requires explicit fly:secrets:write authorization.
update_machine_metadata
ChatGPTSet or remove metadata keys, without replacing other keys. Null or empty values remove keys. Requires machine_version; stale versions fail without updating. Requires explicit fly:machines:write authorization.
update_volume
ChatGPTUpdate the named volume's automatic snapshot setting (auto_backup_enabled) and/or snapshot retention in days (snapshot_retention). Disabling backups or shortening retention reduces recovery coverage. Use extend_volume to increase capacity. Requires explicit fly:volumes:write authorization.
wait_for_machine_state
ChatGPTWait for the named Machine to reach the requested state, optionally for a specific version or instance. This observes state without starting or stopping the Machine. timeout is in seconds, defaults to 10 and cannot exceed 10; a timeout does not change the Machine state. Requires explicit fly:machines:read authorization.
checkpoint_create
Claudecheckpoint_get
Claudecheckpoint_list
Claudecheckpoint_restore
Claudecordon_machine
Claudecreate_machine
Claudecreate_machine_lease
Claudecreate_sprite
Claudecreate_volume
Claudecreate_volume_snapshot
Claudedelete_app
Claudedelete_app_secret
Claudedelete_machine
Claudedelete_machine_metadata_key
Claudedelete_volume
Claudedestroy_sprite
Claudeexec
Claudeexec_kill
Claudeexec_list
Claudeexec_machine_command
Claudeextend_volume
Claudefile_copy
Claudefile_delete
Claudefile_list
Claudefile_read
Claudefile_rename
Claudefile_write
Claudeget_app
Claudeget_app_certificate
Claudeget_app_secret
Claudeget_fly_context
Claudeget_machine
Claudeget_machine_configuration
Claudeget_machine_lease
Claudeget_machine_memory
Claudeget_machine_metadata
Claudeget_machine_metadata_key
Claudeget_sprite_info
Claudeget_volume
Claudelist_app_certificates
Claudelist_app_ips
Claudelist_app_secrets
Claudelist_apps
Claudelist_machine_events
Claudelist_machine_processes
Claudelist_machine_versions
Claudelist_machines
Claudelist_sprites
Claudelist_volume_snapshots
Claudelist_volumes
Claudeopen_sprite_inspector
Claudepolicy_network_get
Claudepolicy_network_update
Claudereclaim_machine_memory
Clauderelease_machine_lease
Clauderestart_machine
Claudeservice_create
Claudeservice_get
Claudeservice_list
Claudeservice_logs
Claudeservice_start
Claudeservice_stop
Claudeset_app_secret
Claudeset_machine_memory_limit
Claudeset_machine_metadata_key
Claudesignal_machine
Claudestart_machine
Claudestop_machine
Claudesuspend_machine
Claudeuncordon_machine
Claudeupdate_app_secrets
Claudeupdate_machine_metadata
Claudeupdate_volume
Claudewait_for_machine_state
Claude