MCP App Store
by KeenEthics
Fly.io icon

Fly.io MCP Server for Claude and ChatGPT

By Fly.io

Overview

Manage your Fly.io apps directly through Claude. Check Machine status and events, start, stop, or restart Machines, and run commands on them to debug. Create and snapshot volumes, set app secrets, and create Managed Postgres clusters, take backups, and find slow queries. Spin up Sprites (full Linux computers for agents) to run code, then checkpoint and restore them.

How to connect

  1. Claude: Open the Fly.io listing in the Claude connectors directory and choose Connect. Claude listing Fly.io exposes 74 tools here.
  2. ChatGPT: Open the Fly.io listing in the ChatGPT app directory and choose Connect. ChatGPT listing Fly.io exposes 94 tools here.

Tools

checkpoint_create

ChatGPT
Create a new checkpoint of the current sprite state. Returns streaming NDJSON progress.

checkpoint_get

ChatGPT
Get details of a specific checkpoint.

checkpoint_list

ChatGPT
List all checkpoints.

checkpoint_restore

ChatGPT
Restore to a specific checkpoint. Returns streaming NDJSON progress.

cordon_machine

ChatGPT
Remove this Machine from proxy routing; existing application work can continue. Requires explicit fly:machines:write authorization.

create_machine

ChatGPT
Create 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

ChatGPT
Acquire 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

ChatGPT
Create a backup for a specific cluster. The backup runs asynchronously and is rejected if one is already in progress.

create_postgres_cluster

ChatGPT
Create 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

ChatGPT
Create a database within a specific cluster.

create_sprite

ChatGPT
Create 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

ChatGPT
Create 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

ChatGPT
Schedule 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

ChatGPT
Permanently delete the app. This can disrupt or delete its resources; inspect the app first. Requires explicit fly:apps:delete authorization.

delete_app_secret

ChatGPT
Delete 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

ChatGPT
Permanently 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

ChatGPT
Remove one metadata key from the named Machine, leaving other keys unchanged. Requires explicit fly:machines:write authorization.

delete_volume

ChatGPT
Permanently destroy a persistent volume and its data. Detach it from Machines before deletion. Requires explicit fly:volumes:delete authorization.

destroy_sprite

ChatGPT
Destroy a sprite in the authenticated organization.

enable_postgres_extension

ChatGPT
Enable a Postgres extension within a specific database. PostGIS extensions require a PostGIS-enabled cluster.

exec

ChatGPT
Run 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

ChatGPT
Kill an exec session by session ID. Returns streaming NDJSON with kill progress.

exec_list

ChatGPT
List active exec sessions.

exec_machine_command

ChatGPT
Execute 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

ChatGPT
Increase 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

ChatGPT
Copy 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

ChatGPT
Delete 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

ChatGPT
List directory contents.

file_read

ChatGPT
Read file contents from the sprite filesystem. Returns raw file bytes.

file_rename

ChatGPT
Rename or move a file or directory on the named Sprite. asRoot defaults to false.

file_write

ChatGPT
Write up to 16 MiB of file contents to the sprite filesystem. Request body contains raw file bytes.

fork_postgres_cluster

ChatGPT
Fork 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

ChatGPT
Read an app's identity, organization, status, and counts.

get_app_certificate

ChatGPT
Read TLS certificate details and validation status for one hostname on the named app. Requires explicit fly:certificates:read authorization.

get_app_secret

ChatGPT
Read one secret's name, digest and timestamps. Its value is never returned. Requires explicit fly:secrets:read authorization.

get_credit_balance

ChatGPT
Read 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

ChatGPT
Show 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

ChatGPT
Explain launch blockers and return browser handoffs for billing, SSO or provider terms. Does not accept terms or alter payment settings.

get_machine

ChatGPT
Read a Machine's identity and lifecycle summary. Excludes configuration and secrets.

get_machine_configuration

ChatGPT
Read 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

ChatGPT
Read the active lease under an explicit management grant. Lease nonces are sensitive concurrency credentials. Requires explicit fly:machines:write authorization.

get_machine_memory

ChatGPT
Read the named Machine's current memory limit and available memory in MiB. Requires explicit fly:machines:write authorization.

get_machine_metadata

ChatGPT
Read arbitrary Machine metadata under explicit authorization; values can be sensitive. Requires explicit fly:machines:sensitive:read authorization.

get_machine_metadata_key

ChatGPT
Read one arbitrary Machine metadata value under explicit authorization. Requires explicit fly:machines:sensitive:read authorization.

get_organization

ChatGPT
Read the selected organization's identity, current role and launch eligibility.

get_postgres_cluster

ChatGPT
Get details of a specific Managed Postgres cluster, including its status and, once it is ready, its endpoints.

get_postgres_plans

ChatGPT
List the Managed Postgres plans available when creating or forking a cluster in an organization, cheapest first.

get_sprite_info

ChatGPT
Read authorized Sprite metadata without waking it. Pass sprite_id from a mention or Inspector selection to reject deleted and recreated environments.

get_volume

ChatGPT
Read 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

ChatGPT
List TLS certificates configured for the named app, including hostnames and certificate status. Requires explicit fly:certificates:read authorization.

list_app_ips

ChatGPT
List 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

ChatGPT
List secret names, digests and timestamps. Secret values are never returned. Requires explicit fly:secrets:read authorization.

list_apps

ChatGPT
List app identity, organization, status, and counts.

list_machine_events

ChatGPT
List 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

ChatGPT
Read process details, which can include sensitive command arguments, under explicit authorization. Requires explicit fly:machines:sensitive:read authorization.

list_machine_versions

ChatGPT
Read historical Machine configurations under explicit authorization. History can contain sensitive environment, file and metadata values. Requires explicit fly:machines:sensitive:read authorization.

list_machines

ChatGPT
List Machine identity and lifecycle summaries for an app. Excludes configuration and secrets.

list_organizations

ChatGPT
List current organization identities and roles under explicitly granted account-directory access. This does not authorize their resources.

list_postgres_active_queries

ChatGPT
List active queries in the supplied database. Returns full query text and durations in seconds.

list_postgres_backups

ChatGPT
List all backups associated with a specific cluster.

list_postgres_clusters

ChatGPT
List Managed Postgres clusters for an organization.

list_postgres_databases

ChatGPT
List all databases within a specific cluster.

list_postgres_extensions

ChatGPT
List all extensions available within a specific database, indicating which are installed.

list_postgres_slow_queries

ChatGPT
List 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

ChatGPT
List all Postgres users within a specific cluster.

list_sprites

ChatGPT
List 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

ChatGPT
List 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

ChatGPT
List 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

ChatGPT
Open 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

ChatGPT
Read the named Sprite's current network policy rules before preparing a replacement.

policy_network_update

ChatGPT
Replace 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

ChatGPT
Request 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

ChatGPT
Release the Machine lease using its exact lease_nonce. Requires explicit fly:machines:write authorization.

restart_machine

ChatGPT
Restart the Machine and interrupt its running work. Requires explicit fly:machines:write authorization.

search_sprite_mentions

ChatGPT
Find up to 20 authorized Sprites by name prefix for composer mentions.

service_create

ChatGPT
Register 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

ChatGPT
Get details of a specific service.

service_list

ChatGPT
List all configured services and their current state.

service_logs

ChatGPT
Stream logs for a service.

service_start

ChatGPT
Start a service. Returns streaming NDJSON with stdout/stderr.

service_stop

ChatGPT
Stop a running service. Returns streaming NDJSON with service stop progress.

set_app_secret

ChatGPT
Set a secret value. The result contains metadata only; secret values are not echoed. Requires explicit fly:secrets:write authorization.

set_machine_memory_limit

ChatGPT
Set 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

ChatGPT
Create or replace the value of one metadata key on the named Machine, leaving other keys unchanged. Requires explicit fly:machines:write authorization.

signal_machine

ChatGPT
Send 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

ChatGPT
Start 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

ChatGPT
Stop running work on the Machine. Existing auto_destroy configuration still applies. Requires explicit fly:machines:write authorization.

submit_feedback

ChatGPT
Send 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

ChatGPT
Suspend running work on the Machine; this interrupts service until resumed. Requires explicit fly:machines:write authorization.

uncordon_machine

ChatGPT
Allow proxy routing to this Machine again. Requires explicit fly:machines:write authorization.

update_app_secrets

ChatGPT
Set 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

ChatGPT
Set 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

ChatGPT
Update 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

ChatGPT
Wait 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

Claude

checkpoint_get

Claude

checkpoint_list

Claude

checkpoint_restore

Claude

cordon_machine

Claude

create_machine

Claude

create_machine_lease

Claude

create_sprite

Claude

create_volume

Claude

create_volume_snapshot

Claude

delete_app

Claude

delete_app_secret

Claude

delete_machine

Claude

delete_machine_metadata_key

Claude

delete_volume

Claude

destroy_sprite

Claude

exec

Claude

exec_kill

Claude

exec_list

Claude

exec_machine_command

Claude

extend_volume

Claude

file_copy

Claude

file_delete

Claude

file_list

Claude

file_read

Claude

file_rename

Claude

file_write

Claude

get_app

Claude

get_app_certificate

Claude

get_app_secret

Claude

get_fly_context

Claude

get_machine

Claude

get_machine_configuration

Claude

get_machine_lease

Claude

get_machine_memory

Claude

get_machine_metadata

Claude

get_machine_metadata_key

Claude

get_sprite_info

Claude

get_volume

Claude

list_app_certificates

Claude

list_app_ips

Claude

list_app_secrets

Claude

list_apps

Claude

list_machine_events

Claude

list_machine_processes

Claude

list_machine_versions

Claude

list_machines

Claude

list_sprites

Claude

list_volume_snapshots

Claude

list_volumes

Claude

open_sprite_inspector

Claude

policy_network_get

Claude

policy_network_update

Claude

reclaim_machine_memory

Claude

release_machine_lease

Claude

restart_machine

Claude

service_create

Claude

service_get

Claude

service_list

Claude

service_logs

Claude

service_start

Claude

service_stop

Claude

set_app_secret

Claude

set_machine_memory_limit

Claude

set_machine_metadata_key

Claude

signal_machine

Claude

start_machine

Claude

stop_machine

Claude

suspend_machine

Claude

uncordon_machine

Claude

update_app_secrets

Claude

update_machine_metadata

Claude

update_volume

Claude

wait_for_machine_state

Claude

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/fly-io"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/fly-io)