The Fly.io MCP connector routes your AI agent's tool calls to Fly.io's own MCP server through Scalekit. Each user signs in to Fly.io once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 47 tools.
- Tools
- 47
- What they doRead · write · destructive
- 27 · 7 · 1327 read7 write13 destructive
- Users sign in with
- OAuth
- OAuth app
- Your own Fly.io MCP server app
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Fly.io MCP connection
In AgentKit > Connections, create a Fly.io MCP connection and copy its redirect URI. The name you give it is the
connection_nameyour code passes. See Configure connections.Register an OAuth app
Fly.io MCP server connections use your own OAuth app. Register one with Fly.io MCP server and add the redirect URI you copied.
Then enter the app's Client ID and Client Secret on the Fly.io MCP connection.
Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'flymcp'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Fly.io MCP:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'flymcp_get_fly_context',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "flymcp"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Fly.io MCP:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="flymcp_get_fly_context",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user signs in once. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolflymcp_checkpoint_getGet details of a specific checkpoint.Read-onlyGet Sprite checkpoint
Get details of a specific checkpoint.
Inputs
checkpoint_idstringrequired- Checkpoint id
spritestringrequired- Name of the sprite to target.
sprite_idstring- Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
flymcp_checkpoint_listList all checkpoints.Read-onlyList Sprite checkpoints
List all checkpoints.
Inputs
spritestringrequired- Name of the sprite to target.
sprite_idstring- Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
flymcp_exec_listList active exec sessions.Read-onlyList Sprite commands
List active exec sessions.
Inputs
spritestringrequired- Name of the sprite to target.
sprite_idstring- Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
flymcp_file_listList directory contents.Read-onlyList Sprite files
List directory contents.
Inputs
pathstringrequired- Path to the directory to list
spritestringrequired- Name of the sprite to target.
sprite_idstring- Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
workingDirstring- Base directory for relative paths. Defaults to /home/sprite; absolute paths are unaffected.default
/home/sprite
flymcp_file_readRead file contents from the sprite filesystem.Read-onlyRead Sprite file
Read file contents from the sprite filesystem. Returns raw file bytes.
Inputs
pathstringrequired- Path to the file to read
spritestringrequired- Name of the sprite to target.
encodingstring- Content encoding for the file read. Use utf8 (the default) for an MCP embedded text resource, or base64 for an MCP embedded binary resource with a base64 blob.one of
utf8base64defaultutf8 sprite_idstring- Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
workingDirstring- Base directory for relative paths. Defaults to /home/sprite; absolute paths are unaffected.default
/home/sprite
flymcp_get_credit_balanceRead the selected organization's purchased credit balance in US cents, the Purchased Credit Balance on its billing page.Read-onlyGet purchased credit balance
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.
Inputs
org_slugstringrequired- No description.
flymcp_get_fly_contextShow this connection's current authorized resource bindings, per-resource scopes, and restrictions, including the Sprites name_prefix and max_sprites_total creation limit.Read-onlyGet fly context
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.
Inputs
This tool takes no inputs.
flymcp_get_launch_requirementsExplain launch blockers and return browser handoffs for billing, SSO or provider terms.Read-onlyGet launch requirements
Explain launch blockers and return browser handoffs for billing, SSO or provider terms. Does not accept terms or alter payment settings.
Inputs
org_slugstringrequired- No description.
flymcp_get_organizationRead the selected organization's identity, current role and launch eligibility.Read-onlyGet organization
Read the selected organization's identity, current role and launch eligibility.
Inputs
org_slugstringrequired- No description.
flymcp_get_postgres_clusterGet details of a specific Managed Postgres cluster, including its status and, once it is ready, its endpoints.Read-onlyGet Managed Postgres cluster
Get details of a specific Managed Postgres cluster, including its status and, once it is ready, its endpoints.
Inputs
org_slugstringrequired- The concrete Fly organization slug; the personal alias is not accepted.
postgres_cluster_idstringrequired- Managed Postgres Cluster ID
flymcp_get_postgres_plansList the Managed Postgres plans available when creating or forking a cluster in an organization, cheapest first.Read-onlyGet Managed Postgres plans
List the Managed Postgres plans available when creating or forking a cluster in an organization, cheapest first.
Inputs
org_slugstringrequired- The concrete Fly organization slug; the personal alias is not accepted.
flymcp_get_sprite_infoRead authorized Sprite metadata without waking it.Read-onlyGet Sprite Info
Read authorized Sprite metadata without waking it. Pass sprite_id from a mention or Inspector selection to reject deleted and recreated environments.
Inputs
spritestringrequired- No description.
sprite_idstring- No description.
flymcp_list_organizationsList current organization identities and roles under explicitly granted account-directory access.Read-onlyList organizations
List current organization identities and roles under explicitly granted account-directory access. This does not authorize their resources.
Inputs
This tool takes no inputs.
flymcp_list_postgres_active_queriesList active queries in the supplied database.Read-onlyList Managed Postgres active queries
List active queries in the supplied database. Returns full query text and durations in seconds.
Inputs
databasestringrequired- Database to inspect
org_slugstringrequired- The concrete Fly organization slug; the personal alias is not accepted.
postgres_cluster_idstringrequired- Managed Postgres Cluster ID
flymcp_list_postgres_backupsList all backups associated with a specific cluster.Read-onlyList Managed Postgres backups
List all backups associated with a specific cluster.
Inputs
org_slugstringrequired- The concrete Fly organization slug; the personal alias is not accepted.
postgres_cluster_idstringrequired- Managed Postgres Cluster ID
flymcp_list_postgres_clustersList Managed Postgres clusters for an organization.Read-onlyList Managed Postgres clusters
List Managed Postgres clusters for an organization.
Inputs
org_slugstringrequired- The concrete Fly organization slug; the personal alias is not accepted.
include_deletedboolean- Include deleted clusters
flymcp_list_postgres_databasesList all databases within a specific cluster.Read-onlyList Managed Postgres databases
List all databases within a specific cluster.
Inputs
org_slugstringrequired- The concrete Fly organization slug; the personal alias is not accepted.
postgres_cluster_idstringrequired- Managed Postgres Cluster ID
flymcp_list_postgres_extensionsList all extensions available within a specific database, indicating which are installed.Read-onlyList Managed Postgres extensions
List all extensions available within a specific database, indicating which are installed.
Inputs
database_namestringrequired- Database Name
org_slugstringrequired- The concrete Fly organization slug; the personal alias is not accepted.
postgres_cluster_idstringrequired- Managed Postgres Cluster ID
flymcp_list_postgres_slow_queriesList the top 20 queries by cumulative total execution time, excluding the postgres database.Read-onlyList Managed Postgres slow queries
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.
Inputs
org_slugstringrequired- The concrete Fly organization slug; the personal alias is not accepted.
postgres_cluster_idstringrequired- Managed Postgres Cluster ID
rangeinteger- Metrics lookback in secondsdefault
3600
flymcp_list_postgres_usersList all Postgres users within a specific cluster.Read-onlyList Managed Postgres users
List all Postgres users within a specific cluster.
Inputs
org_slugstringrequired- The concrete Fly organization slug; the personal alias is not accepted.
postgres_cluster_idstringrequired- Managed Postgres Cluster ID
flymcp_list_spritesList Sprites visible to this connection.Read-onlyList Sprites
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.
Inputs
continuation_tokenstring- No description.
max_resultsinteger- No description.
prefixstring- No description.
flymcp_open_sprite_inspectorOpen a read-only Sprite Inspector showing environments, services, checkpoints and recent service logs.Read-onlySprite Inspector
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.
Inputs
continuation_tokenstring- No description.
prefixstring- No description.
spritestring- No description.
sprite_idstring- No description.
flymcp_policy_network_getRead the named Sprite's current network policy rules before preparing a replacement.Read-onlyGet Sprite network policy
Read the named Sprite's current network policy rules before preparing a replacement.
Inputs
spritestringrequired- Name of the sprite to target.
sprite_idstring- Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
flymcp_search_sprite_mentionsFind up to 20 authorized Sprites by name prefix for composer mentions.Read-onlyFind Sprites
Find up to 20 authorized Sprites by name prefix for composer mentions.
Inputs
querystringrequired- No description.
flymcp_service_getGet details of a specific service.Read-onlyGet Sprite service
Get details of a specific service.
Inputs
service_namestringrequired- Service name
spritestringrequired- Name of the sprite to target.
sprite_idstring- Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
flymcp_service_listList all configured services and their current state.Read-onlyList Sprite services
List all configured services and their current state.
Inputs
spritestringrequired- Name of the sprite to target.
sprite_idstring- Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
flymcp_service_logsStream logs for a service.Read-onlyGet Sprite service logs
Stream logs for a service.
Inputs
service_namestringrequired- Service name
spritestringrequired- Name of the sprite to target.
durationstring- Time to follow new logs (default: `0`, no follow)
linesinteger- Number of lines to return from log buffer (default: all)
sprite_idstring- Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
flymcp_checkpoint_createCreate a new checkpoint of the current sprite state.WriteCreate Sprite checkpoint
Create a new checkpoint of the current sprite state. Returns streaming NDJSON progress.
Inputs
spritestringrequired- Name of the sprite to target.
commentstring- No description.
sprite_idstring- Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
flymcp_create_postgres_backupCreate a backup for a specific cluster.WriteCreate Managed Postgres backup
Create a backup for a specific cluster. The backup runs asynchronously and is rejected if one is already in progress.
Inputs
bodyobjectrequired- No description.
org_slugstringrequired- The concrete Fly organization slug; the personal alias is not accepted.
postgres_cluster_idstringrequired- Managed Postgres Cluster ID
flymcp_create_postgres_clusterCreate a Managed Postgres cluster in the organization.WriteCreate Managed Postgres cluster
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.
Inputs
bodyobjectrequired- No description.
org_slugstringrequired- The concrete Fly organization slug; the personal alias is not accepted.
flymcp_create_postgres_databaseCreate a database within a specific cluster.WriteCreate Managed Postgres database
Create a database within a specific cluster.
Inputs
bodyobjectrequired- No description.
org_slugstringrequired- The concrete Fly organization slug; the personal alias is not accepted.
postgres_cluster_idstringrequired- Managed Postgres Cluster ID
flymcp_create_spriteCreate a Sprite within this connection's grant restrictions.WriteCreate Sprite
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.
Inputs
namestringrequired- No description.
wait_for_capacityboolean- No description.
flymcp_enable_postgres_extensionEnable a Postgres extension within a specific database.WriteEnable Managed Postgres extension
Enable a Postgres extension within a specific database. PostGIS extensions require a PostGIS-enabled cluster.
- Idempotent
Inputs
bodyobjectrequired- No description.
database_namestringrequired- Database Name
org_slugstringrequired- The concrete Fly organization slug; the personal alias is not accepted.
postgres_cluster_idstringrequired- Managed Postgres Cluster ID
flymcp_fork_postgres_clusterFork a ready Managed Postgres cluster into a new cluster that inherits the source's settings, on the source's plan unless plan is given.WriteFork Managed Postgres cluster
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.
Inputs
org_slugstringrequired- The concrete Fly organization slug; the personal alias is not accepted.
postgres_cluster_idstringrequired- Managed Postgres Cluster ID
bodyobject- No description.
flymcp_checkpoint_restoreRestore to a specific checkpoint.DestructiveRestore Sprite checkpoint
Restore to a specific checkpoint. Returns streaming NDJSON progress.
Inputs
checkpoint_idstringrequired- Checkpoint id
spritestringrequired- Name of the sprite to target.
sprite_idstring- Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
flymcp_destroy_spriteDestroy a sprite in the authenticated organization.DestructiveDestroy Sprite
Destroy a sprite in the authenticated organization.
- Idempotent
Inputs
namestringrequired- No description.
flymcp_execRun a command on the named Sprite without a TTY and return its output; interactive commands that need a terminal are not supported.DestructiveRun command in Sprite
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.
Inputs
cmdstringrequired- Command to execute. Pass an array of strings (executable then arguments) to keep arguments containing spaces intact; a string is split on whitespace.
spritestringrequired- Name of the sprite to target.
dirstring- Working directory for the command
envstring- Environment variables in `KEY=VALUE` format (can be repeated)
pathstring- Explicit path to executable (defaults to first `cmd` value or `bash`)
sprite_idstring- Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
stdinboolean- Enable stdin from request body (default: `false`)
flymcp_exec_killKill an exec session by session ID.DestructiveKill Sprite command
Kill an exec session by session ID. Returns streaming NDJSON with kill progress.
Inputs
session_idstringrequired- Session id
spritestringrequired- Name of the sprite to target.
signalstring- Signal to send (default: `SIGTERM`)
sprite_idstring- Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
timeoutstring- Timeout waiting for process to exit (default: `10s`)
flymcp_file_copyCopy a file or directory on the named Sprite.DestructiveCopy Sprite file
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.
- Idempotent
Inputs
deststringrequired- No description.
sourcestringrequired- No description.
spritestringrequired- Name of the sprite to target.
asRootboolean- Perform the operation as root. Defaults to false (use the Sprite user).default
false preserveAttrsboolean- Preserve file attributes when copying. Defaults to false.default
false recursiveboolean- Operate recursively on directory contents. Defaults to false.default
false sprite_idstring- Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
workingDirstring- Base directory for relative paths. Defaults to /home/sprite; absolute paths are unaffected.default
/home/sprite
flymcp_file_deleteDelete a file or directory on the named Sprite.DestructiveDelete Sprite file
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.
- Idempotent
Inputs
pathstringrequired- No description.
spritestringrequired- Name of the sprite to target.
asRootboolean- Perform the operation as root. Defaults to false (use the Sprite user).default
false recursiveboolean- Operate recursively on directory contents. Defaults to false.default
false sprite_idstring- Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
workingDirstring- Base directory for relative paths. Defaults to /home/sprite; absolute paths are unaffected.default
/home/sprite
flymcp_file_renameRename or move a file or directory on the named Sprite.DestructiveRename Sprite file
Rename or move a file or directory on the named Sprite. asRoot defaults to false.
Inputs
deststringrequired- No description.
sourcestringrequired- No description.
spritestringrequired- Name of the sprite to target.
asRootboolean- Perform the operation as root. Defaults to false (use the Sprite user).default
false sprite_idstring- Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
workingDirstring- Base directory for relative paths. Defaults to /home/sprite; absolute paths are unaffected.default
/home/sprite
flymcp_file_writeWrite up to 16 MiB of file contents to the sprite filesystem.DestructiveWrite Sprite file
Write up to 16 MiB of file contents to the sprite filesystem. Request body contains raw file bytes.
- Idempotent
Inputs
contentstringrequired- For utf8, the literal text to write. For base64, RFC 4648 base64-encoded bytes without a data URL prefix; the server decodes them before writing.
pathstringrequired- Path to the file to write
spritestringrequired- Name of the sprite to target.
encodingstring- Content encoding for the file write. Use utf8 (the default) for literal text, or base64 when content contains RFC 4648 base64-encoded bytes without a data URL prefix.one of
utf8base64defaultutf8 mkdirboolean- Create parent directories if they don't exist
modestring- File permissions in octal (e.g., '0644')
sprite_idstring- Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
workingDirstring- Base directory for relative paths. Defaults to /home/sprite; absolute paths are unaffected.default
/home/sprite
flymcp_policy_network_updateReplace the named Sprite's entire network policy with the supplied rules; this does not append rules.DestructiveUpdate Sprite network policy
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.
- Idempotent
Inputs
rulesarrayrequired- List of network policy rules
spritestringrequired- Name of the sprite to target.
sprite_idstring- Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
flymcp_service_createRegister a named service on the Sprite.DestructiveCreate Sprite service
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.
Inputs
argsarrayrequired- Command arguments
cmdstringrequired- Command to execute
needsarrayrequired- Service dependencies (started first)
service_namestringrequired- Service name
spritestringrequired- Name of the sprite to target.
durationstring- Legacy Sprites only: time to monitor initial logs after starting a new service (default: `5s`). Provider-backed Sprites do not use this to monitor logs.
http_portinteger- HTTP port for proxy routing
sprite_idstring- Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
flymcp_service_startStart a service.DestructiveStart Sprite service
Start a service. Returns streaming NDJSON with stdout/stderr.
Inputs
service_namestringrequired- Service name
spritestringrequired- Name of the sprite to target.
durationstring- Time to monitor logs after starting (default: `5s`)
sprite_idstring- Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
flymcp_service_stopStop a running service.DestructiveStop Sprite service
Stop a running service. Returns streaming NDJSON with service stop progress.
- Idempotent
Inputs
service_namestringrequired- Service name
spritestringrequired- Name of the sprite to target.
sprite_idstring- Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
timeoutstring- Timeout waiting for service to stop (default: `10s`)
flymcp_submit_feedbackSend the Fly.io team a report about a Fly.io platform bug, a documentation problem or a missing feature you hit while working.DestructiveSubmit feedback to Fly.io
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. Do not report errors in the user's own application, and never include secrets, tokens, credentials or customer data.
Inputs
categorystringrequired- bug: Fly.io behaved wrongly. documentation: docs or tool descriptions disagree with behaviour. feature_request: something you needed is not possible. other: anything else.one of
bugdocumentationfeature_requestother notestringrequired- What happened, what you expected, and what you were trying to do. Never include secrets, tokens, credentials or customer data.
org_slugstringrequired- An organization this connection is authorized for (see get_fly_context). The report is filed under it.
request_idstring- The request ID of the call this is about: the io.fly/request_id value in that tool result's _meta, or a fly-request-id response header.
toolstring- The name of the Fly MCP tool this is about, when you have no request ID.
urlstring- A page this is about, such as a Fly.io docs page.
No tools match.