Connectors · Developer & infrastructure
Fly.io Machines MCP server for AI agents.
actionlake is an MCP gateway: one remote MCP server that connects Claude and other MCP clients to Fly.io Machines and the rest of your systems. It gives your agent 99 Fly.io Machines actions (43 reads, 38 writes and 18 that wait for a confirmation) and holds the Fly.io Machines credential itself, so the agent never does. It paces Fly.io Machines's limits and records every call.
100,000 free calls a month. No card, no email, no password: press Start a free sandbox on the next screen and keep the key it shows you.
claude mcp add --transport http actionlake https://connect.actionlake.com/mcpdo { action: "fly_io_machines.platform.regions.list", intent: "check which Fly.io Machines account is connected"}# List Fly.io regions · read · 1 upstream call- 99actionsin one signed file
- 43readlook, never change
- 38writecreate and update
- 18wait for a yesdestructive, confirmed first
Set up
Connect Fly.io Machines in three steps.
- 01
Add actionlake to Claude.
Run the command once in Claude Code; its consent page can create a free sandbox: 100,000 calls a month, no card. In the Claude app, add a custom connector with the URL below and paste your key on the consent page. Creating a new sandbox from the Claude app is not yet tested by us.
https://connect.actionlake.com/mcp - 02
Connect Fly.io Machines.
Bearer token. No consent screen: your agent can connect it for you, but the key then passes through your chat. To keep it out of the model's context, paste it in the console instead. actionlake stores what you paste write-only, sealed under your tenant's key.
api_tokenFly.io API token (from `fly tokens create org` or `fly tokens deploy`; paste the whole value, including any `FlyV1 `…
account { op: "connections.requirements", service: "fly_io_machines" } # free: exactly what to paste, and what is found for you - 03
Make the first call. Check before a write.
Ask in plain words; Claude picks the action. Before anything changes,
checkvalidates the call and prices it, for free.do { action: "fly_io_machines.platform.regions.list" }# list fly.io regions · read · 1 upstream callcheck { action: "fly_io_machines.machines.create", input: { … } }# free: inputs, permissions, cost and confirmations, nothing sent
Fly.io Machines at a glance
- Sign-in
- Bearer token. No consent screen: your agent can connect it for you, but the key then passes through your chat. To keep it out of the model's context, paste it in the console instead.
- You provide
api_token- Limits we pace to
- 3 calls a second, per connection
- API covered
- Machines API 1.0 (OpenAPI 3.1.0)
api.machines.dev - Built from
- Fly.io Machines's documentation, read 23 October 2026docs.fly.iofly.io
- Service file
- Version 1.0.0, signed (Ed25519)
- Cached reads
- 25 of 43 reads, for up to an hour; a write clears what it affects
- Shared entities
- 2, so ask can line Fly.io Machines up with your other systems
- Data
- Processed and stored in Sydney, Australia. No US region yet
Capabilities
What an AI agent can do in Fly.io Machines.
99 actions in 12 areas. Every one carries its effect, so a key can allow the reads and hold the rest.
- 43readlook, never change
- 38writecreate and update
- 18destructivewait for a confirmation
Machines
2910 read · 15 write · 4 destructive
Get a machine · Create a machine · Update a machine's configuration · Destroy a machine
Postgres
2510 read · 9 write · 6 destructive
List Managed Postgres clusters · List a cluster's databases · List a cluster's users · Get a Managed Postgres cluster
Secret keys
96 read · 2 write · 1 destructive
List an app's secret keys · Get an app secret key · Decrypt ciphertext with an app secret key · Encrypt plaintext with an app secret key
Certificates
82 read · 3 write · 3 destructive
List an app's certificates · Get a certificate for a hostname · Request an ACME (Let's Encrypt) certificate · Upload a custom certificate
Volumes
83 read · 4 write · 1 destructive
List a volume's snapshots · Get a volume · Create a volume · Create a volume snapshot
Apps
52 read · 2 write · 1 destructive
List apps in an organization · Get an app · Create an app · Delete an app
Secrets
52 read · 2 write · 1 destructive
List an app's secrets · Get an app secret · Set or unset several app secrets · Delete an app secret
Ip assignments
31 read · 1 write · 1 destructive
List an app's IP addresses · Allocate an IP address to an app · Release an app's IP address
4 more areas · 7 actions
- Tokens 3
- Platform 2
- Org machines 1
- Org volumes 1
Top actions
The Fly.io Machines API, shaped for agents.
The ids your agent types, what each does, and the one name it shares with other systems. 35 of Fly.io Machines's 35 action names are shared with at least one other connector, so an agent learns them once.
| Action | What it does | Effect | Same name in |
|---|---|---|---|
fly_io_machines.org_machines.listList machines across an organization | List All Machines. | read | infra.instance.list18 connectors |
fly_io_machines.apps.listList apps in an organization | List Apps. | read | infra.container_service.list11 connectors |
fly_io_machines.machines.getGet a machine | Get Machine. | read | infra.instance.get15 connectors |
fly_io_machines.apps.getGet an app | Get App. | read | infra.container_service.get11 connectors |
fly_io_machines.machines.createCreate a machine | Create Machine. | write | infra.instance.create10 connectors |
fly_io_machines.apps.createCreate an app | Create App. | write | infra.container_service.create8 connectors |
fly_io_machines.org_volumes.listList volumes across an organization | List All Volumes. | read | infra.volume.list10 connectors |
fly_io_machines.machines.updateUpdate a machine's configuration | Update Machine. | write | infra.instance.update15 connectors |
fly_io_machines.ip_assignments.listList an app's IP addresses | List IP assignments for app. | read | infra.ip_address.list9 connectors |
fly_io_machines.platform.regions.listList Fly.io regions | Get Regions. | read | infra.region.list16 connectors |
fly_io_machines.volumes.snapshots.listList a volume's snapshots | List Snapshots. | read | infra.snapshot.list12 connectors |
fly_io_machines.machines.deleteDestroy a machine | Destroy Machine. | destructive | infra.instance.delete13 connectors |
Try it
Prompts to paste into Claude.
Each one names the Fly.io Machines actions it will call, so you know what it reads and what it changes before you send it.
- Readread
List Fly.io regions in Fly.io Machines and tell me what stands out.
calls
fly_io_machines.platform.regions.list - Writewrite
Create a machine in Fly.io Machines. Show me exactly what you will send before you save it.
calls
fly_io_machines.machines.create
Governance for Fly.io Machines
Destructive actions wait for a yes.
18 Fly.io Machines actions are destructive. These are all of them:
- Destroy a machine
fly_io_machines.machines.delete - Delete an app
fly_io_machines.apps.delete - Destroy a volume
fly_io_machines.volumes.delete - Release an app's IP address
fly_io_machines.ip_assignments.delete - Delete a Managed Postgres cluster
fly_io_machines.postgres.delete - Delete a cluster user
fly_io_machines.postgres.users.delete - Delete a database from a cluster
fly_io_machines.postgres.databases.delete - Delete an app secret
fly_io_machines.secrets.delete - Restart a machine
fly_io_machines.machines.restart - Delete an app secret key
fly_io_machines.secret_keys.delete - Remove a hostname and all its certificates
fly_io_machines.certificates.delete - Release a machine lease
fly_io_machines.machines.lease.delete - Remove a hostname's ACME certificates
fly_io_machines.certificates.acme.delete - Remove a hostname's custom certificate
fly_io_machines.certificates.custom.delete - Detach a Managed Postgres cluster from an app
fly_io_machines.postgres.attachments.delete - Disable an extension on a database
fly_io_machines.postgres.extensions.disable - Rotate a cluster user's password
fly_io_machines.postgres.users.rotate_password - Delete one machine metadata value
fly_io_machines.machines.metadata.key.delete
A destructive action runs only with confirm: true. Under the human policy the agent cannot confirm for itself: the run stops until a named person approves, in the console or from a signed link in an email. The cap on a key is refused before the call is sent, never after.
Destroy a machine?
intent: the user asked me to destroy a machine
account { op: "keys.create", name: "fly-io-machines-agent", allowed_actions: ["fly_io_machines.*"], cap_calls: 2000, confirm_policy: "human_for_writes", approval_rules: [ { match: "fly_io_machines.machines.delete", approver: "[email protected]" }, { match: "fly_io_machines.apps.delete", approver: "[email protected]" }, { match: "fly_io_machines.volumes.delete", approver: "[email protected]" } ]}Cost
What Fly.io Machines costs on actionlake.
Every Fly.io Machines action is one upstream call, the only thing actionlake bills. Searching, check, cost, account and any call Fly.io Machines refused with 401, 403, 429 or a 5xx are free. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.
- 1upstream call per actionall 99 Fly.io Machines actions
- 99actions pageeach page of a long list is one call
- 25reads can be cacheda cache hit costs nothing
- 100,000calls a month, freepaid plans from US$49 a month for 250,000
Action index
Every Fly.io Machines action.
99 actions by area: the id your agent calls, what it does, and its effect.
Machines29
fly_io_machines.machines.cordonCordon a machine (stop routing traffic to it)writefly_io_machines.machines.createCreate a machinewritefly_io_machines.machines.deleteDestroy a machinedestructivefly_io_machines.machines.events.listList a machine's eventsreadfly_io_machines.machines.execExecute a command on a machinewritefly_io_machines.machines.getGet a machinereadfly_io_machines.machines.lease.createCreate or refresh a machine leasewritefly_io_machines.machines.lease.deleteRelease a machine leasedestructivefly_io_machines.machines.lease.getGet a machine's leasereadfly_io_machines.machines.listList an app's machinesreadfly_io_machines.machines.memory.getGet a machine's memory limit and availabilityreadfly_io_machines.machines.memory.reclaimReclaim memory from a machine's balloon devicewritefly_io_machines.machines.memory.updateSet a machine's memory limitwritefly_io_machines.machines.metadata.getGet a machine's metadatareadfly_io_machines.machines.metadata.key.deleteDelete one machine metadata valuedestructivefly_io_machines.machines.metadata.key.getGet one machine metadata valuereadfly_io_machines.machines.metadata.key.upsertSet one machine metadata valuewritefly_io_machines.machines.metadata.replaceReplace a machine's metadata (deprecated PUT)writefly_io_machines.machines.metadata.updateUpdate a machine's metadatawritefly_io_machines.machines.processes.listList processes running on a machinereadfly_io_machines.machines.restartRestart a machinedestructivefly_io_machines.machines.signalSend a signal to a machinewritefly_io_machines.machines.startStart a machinewritefly_io_machines.machines.stopStop a machinewritefly_io_machines.machines.suspendSuspend a machinewritefly_io_machines.machines.uncordonUncordon a machine (resume routing traffic)writefly_io_machines.machines.updateUpdate a machine's configurationwritefly_io_machines.machines.versions.listList a machine's config versionsreadfly_io_machines.machines.waitWait for a machine to reach a stateread
Postgres25
fly_io_machines.postgres.attachments.createAttach a Managed Postgres cluster to an appwritefly_io_machines.postgres.attachments.deleteDetach a Managed Postgres cluster from an appdestructivefly_io_machines.postgres.backups.createStart a cluster backupwritefly_io_machines.postgres.backups.listList a cluster's backupsreadfly_io_machines.postgres.createCreate a Managed Postgres clusterwritefly_io_machines.postgres.databases.createCreate a database in a clusterwritefly_io_machines.postgres.databases.deleteDelete a database from a clusterdestructivefly_io_machines.postgres.databases.listList a cluster's databasesreadfly_io_machines.postgres.deleteDelete a Managed Postgres clusterdestructivefly_io_machines.postgres.extensions.disableDisable an extension on a databasedestructivefly_io_machines.postgres.extensions.enableEnable an extension on a databasewritefly_io_machines.postgres.extensions.listList a database's extensionsreadfly_io_machines.postgres.forkFork a clusterwritefly_io_machines.postgres.getGet a Managed Postgres clusterreadfly_io_machines.postgres.listList Managed Postgres clustersreadfly_io_machines.postgres.plans.listList Managed Postgres plansreadfly_io_machines.postgres.queries.active.listList a cluster's active queriesreadfly_io_machines.postgres.queries.slow.listList a cluster's slow queriesreadfly_io_machines.postgres.restoreRestore a cluster into a new clusterwritefly_io_machines.postgres.users.createCreate a cluster userwritefly_io_machines.postgres.users.credentials.getGet a cluster user's credentialsreadfly_io_machines.postgres.users.deleteDelete a cluster userdestructivefly_io_machines.postgres.users.listList a cluster's usersreadfly_io_machines.postgres.users.rotate_passwordRotate a cluster user's passworddestructivefly_io_machines.postgres.users.updateChange a cluster user's rolewrite
Secret keys9
fly_io_machines.secret_keys.decryptDecrypt ciphertext with an app secret keyreadfly_io_machines.secret_keys.deleteDelete an app secret keydestructivefly_io_machines.secret_keys.encryptEncrypt plaintext with an app secret keyreadfly_io_machines.secret_keys.generateGenerate a random app secret keywritefly_io_machines.secret_keys.getGet an app secret keyreadfly_io_machines.secret_keys.listList an app's secret keysreadfly_io_machines.secret_keys.setCreate or replace an app secret keywritefly_io_machines.secret_keys.signSign plaintext with an app secret keyreadfly_io_machines.secret_keys.verifyVerify a signature with an app secret keyread
Certificates8
fly_io_machines.certificates.acme.createRequest an ACME (Let's Encrypt) certificatewritefly_io_machines.certificates.acme.deleteRemove a hostname's ACME certificatesdestructivefly_io_machines.certificates.checkCheck a certificate's DNS and trigger validationwritefly_io_machines.certificates.custom.createUpload a custom certificatewritefly_io_machines.certificates.custom.deleteRemove a hostname's custom certificatedestructivefly_io_machines.certificates.deleteRemove a hostname and all its certificatesdestructivefly_io_machines.certificates.getGet a certificate for a hostnamereadfly_io_machines.certificates.listList an app's certificatesread
Volumes8
fly_io_machines.volumes.createCreate a volumewritefly_io_machines.volumes.deleteDestroy a volumedestructivefly_io_machines.volumes.extendExtend a volume's sizewritefly_io_machines.volumes.getGet a volumereadfly_io_machines.volumes.listList an app's volumesreadfly_io_machines.volumes.snapshots.createCreate a volume snapshotwritefly_io_machines.volumes.snapshots.listList a volume's snapshotsreadfly_io_machines.volumes.updateUpdate a volumewrite
Apps5
fly_io_machines.apps.createCreate an appwritefly_io_machines.apps.deleteDelete an appdestructivefly_io_machines.apps.deploy_token.createCreate a deploy token for an appwritefly_io_machines.apps.getGet an appreadfly_io_machines.apps.listList apps in an organizationread
Secrets5
fly_io_machines.secrets.deleteDelete an app secretdestructivefly_io_machines.secrets.getGet an app secretreadfly_io_machines.secrets.listList an app's secretsreadfly_io_machines.secrets.setCreate or replace an app secretwritefly_io_machines.secrets.updateSet or unset several app secretswrite
Ip assignments3
fly_io_machines.ip_assignments.createAllocate an IP address to an appwritefly_io_machines.ip_assignments.deleteRelease an app's IP addressdestructivefly_io_machines.ip_assignments.listList an app's IP addressesread
Tokens3
fly_io_machines.tokens.authenticateAuthenticate a Fly token and list its permissionsreadfly_io_machines.tokens.authorizeCheck whether a Fly token grants an accessreadfly_io_machines.tokens.current.getGet the current token's detailsread
Platform2
fly_io_machines.platform.placements.queryGet recommended regions for machine placementreadfly_io_machines.platform.regions.listList Fly.io regionsread
Org machines1
fly_io_machines.org_machines.listList machines across an organizationread
Org volumes1
fly_io_machines.org_volumes.listList volumes across an organizationread
Questions
The Fly.io Machines MCP server, answered.
Is there a Fly.io Machines MCP server for Claude?
Yes. actionlake is an MCP gateway: a remote MCP server that gives Claude, or another MCP client, 99 Fly.io Machines actions across machines, postgres, secret keys and certificates, through the same eight tools it uses for every other connector. actionlake is independent; it is not made or endorsed by Fly.io Machines.
What do I need to connect Fly.io Machines?
Fly.io API token (from `fly tokens create org` or `fly tokens deploy`; paste the whole value, including any `FlyV1 `…. The free call account { op: "connections.requirements", service: "fly_io_machines" } lists exactly what to paste.
Can an AI agent delete or change things in Fly.io Machines?
Only if its key allows it, and only with an explicit confirmation. 18 Fly.io Machines actions are destructive, including destroy a machine, delete an app and destroy a volume. Each runs only with confirm: true. Under the human confirm policy, or an approval rule on the key, the run waits until a named person approves it.
Will an AI agent use up my Fly.io Machines API limit?
actionlake paces every call to the limits in the Fly.io Machines service file: 3 calls a second per connection. Repeated reads are answered from cache (25 Fly.io Machines actions can be), which never reaches Fly.io Machines.
What does a Fly.io Machines action cost?
One upstream call, the only unit actionlake bills. A list that pages bills one call per page (99 Fly.io Machines actions page). Cache hits, searches, dry runs and calls Fly.io Machines refused with 401, 403, 429 or a 5xx are free. The Free plan includes 100,000 calls a month with no card. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.
Which Fly.io Machines API does it cover?
The Machines API 1.0 (OpenAPI 3.1.0) at api.machines.dev. It is built from Fly.io Machines's documentation as read on 23 October 2026. 99 actions in 12 areas, each one in the signed service file (version 1.0.0).
Does actionlake keep my Fly.io Machines data, and where?
actionlake processes and stores data in Sydney, Australia; there is no US region yet. Reads may be cached for up to an hour, and a write clears the reads it affects. Each run's request and response is kept, sealed, for your plan's trace window: 1 day on Free, 3 days on Starter, 7 days on Pro, 14 days on Team, 30 days on Business and 30 days on Enterprise. Your Fly.io Machines credential is sealed under your tenant's key, never logged and never returned. Your traffic is not used to train models.
Which AI clients can use it?
Claude Code, tested by us end to end, and the Claude app as a custom connector, tested by us with an existing key. Other MCP clients that support remote servers over Streamable HTTP (MCP revisions 2025-06-18 and 2025-11-25) and OAuth dynamic client registration, or a bearer header, should connect the same way; we have not tested them. Or plain REST, under the same action names.
Give your agent Fly.io Machines today.
Start free - 100,000 calls/month, no card. No signup. Hard caps on every key. Cached answers are free.