Skip to content

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/mcp
the first call
do {  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.

  1. 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
  2. 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
  3. 03

    Make the first call. Check before a write.

    Ask in plain words; Claude picks the action. Before anything changes, check validates 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
  1. Machines

    29

    10 read · 15 write · 4 destructive

    Get a machine · Create a machine · Update a machine's configuration · Destroy a machine

  2. Postgres

    25

    10 read · 9 write · 6 destructive

    List Managed Postgres clusters · List a cluster's databases · List a cluster's users · Get a Managed Postgres cluster

  3. Secret keys

    9

    6 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

  4. Certificates

    8

    2 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

  5. Volumes

    8

    3 read · 4 write · 1 destructive

    List a volume's snapshots · Get a volume · Create a volume · Create a volume snapshot

  6. Apps

    5

    2 read · 2 write · 1 destructive

    List apps in an organization · Get an app · Create an app · Delete an app

  7. Secrets

    5

    2 read · 2 write · 1 destructive

    List an app's secrets · Get an app secret · Set or unset several app secrets · Delete an app secret

  8. Ip assignments

    3

    1 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.

ActionWhat it doesEffectSame name in
fly_io_machines.org_machines.listList machines across an organizationList All Machines.readinfra.instance.list18 connectors
fly_io_machines.apps.listList apps in an organizationList Apps.readinfra.container_service.list11 connectors
fly_io_machines.machines.getGet a machineGet Machine.readinfra.instance.get15 connectors
fly_io_machines.apps.getGet an appGet App.readinfra.container_service.get11 connectors
fly_io_machines.machines.createCreate a machineCreate Machine.writeinfra.instance.create10 connectors
fly_io_machines.apps.createCreate an appCreate App.writeinfra.container_service.create8 connectors
fly_io_machines.org_volumes.listList volumes across an organizationList All Volumes.readinfra.volume.list10 connectors
fly_io_machines.machines.updateUpdate a machine's configurationUpdate Machine.writeinfra.instance.update15 connectors
fly_io_machines.ip_assignments.listList an app's IP addressesList IP assignments for app.readinfra.ip_address.list9 connectors
fly_io_machines.platform.regions.listList Fly.io regionsGet Regions.readinfra.region.list16 connectors
fly_io_machines.volumes.snapshots.listList a volume's snapshotsList Snapshots.readinfra.snapshot.list12 connectors
fly_io_machines.machines.deleteDestroy a machineDestroy Machine.destructiveinfra.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.

  1. Readread

    List Fly.io regions in Fly.io Machines and tell me what stands out.

    callsfly_io_machines.platform.regions.list

  2. Writewrite

    Create a machine in Fly.io Machines. Show me exactly what you will send before you save it.

    callsfly_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 machinefly_io_machines.machines.delete
  • Delete an appfly_io_machines.apps.delete
  • Destroy a volumefly_io_machines.volumes.delete
  • Release an app's IP addressfly_io_machines.ip_assignments.delete
  • Delete a Managed Postgres clusterfly_io_machines.postgres.delete
  • Delete a cluster userfly_io_machines.postgres.users.delete
  • Delete a database from a clusterfly_io_machines.postgres.databases.delete
  • Delete an app secretfly_io_machines.secrets.delete
  • Restart a machinefly_io_machines.machines.restart
  • Delete an app secret keyfly_io_machines.secret_keys.delete
  • Remove a hostname and all its certificatesfly_io_machines.certificates.delete
  • Release a machine leasefly_io_machines.machines.lease.delete
  • Remove a hostname's ACME certificatesfly_io_machines.certificates.acme.delete
  • Remove a hostname's custom certificatefly_io_machines.certificates.custom.delete
  • Detach a Managed Postgres cluster from an appfly_io_machines.postgres.attachments.delete
  • Disable an extension on a databasefly_io_machines.postgres.extensions.disable
  • Rotate a cluster user's passwordfly_io_machines.postgres.users.rotate_password
  • Delete one machine metadata valuefly_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.

dofly_io_machines.machines.deleteconfirm_policy: human

Destroy a machine?

intent: the user asked me to destroy a machine

run suspended · waiting for a named person · key fly-io-machines-agent cannot confirm itself
In the console, or from an emailed signed link.
a key for this connector
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]" }  ]}
Illustrative. Scoped to Fly.io Machines only, capped at 2,000 upstream calls, every write confirmed, and the destructive ones approved by a named person.

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

See pricing

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)write
  • fly_io_machines.machines.createCreate a machinewrite
  • fly_io_machines.machines.deleteDestroy a machinedestructive
  • fly_io_machines.machines.events.listList a machine's eventsread
  • fly_io_machines.machines.execExecute a command on a machinewrite
  • fly_io_machines.machines.getGet a machineread
  • fly_io_machines.machines.lease.createCreate or refresh a machine leasewrite
  • fly_io_machines.machines.lease.deleteRelease a machine leasedestructive
  • fly_io_machines.machines.lease.getGet a machine's leaseread
  • fly_io_machines.machines.listList an app's machinesread
  • fly_io_machines.machines.memory.getGet a machine's memory limit and availabilityread
  • fly_io_machines.machines.memory.reclaimReclaim memory from a machine's balloon devicewrite
  • fly_io_machines.machines.memory.updateSet a machine's memory limitwrite
  • fly_io_machines.machines.metadata.getGet a machine's metadataread
  • fly_io_machines.machines.metadata.key.deleteDelete one machine metadata valuedestructive
  • fly_io_machines.machines.metadata.key.getGet one machine metadata valueread
  • fly_io_machines.machines.metadata.key.upsertSet one machine metadata valuewrite
  • fly_io_machines.machines.metadata.replaceReplace a machine's metadata (deprecated PUT)write
  • fly_io_machines.machines.metadata.updateUpdate a machine's metadatawrite
  • fly_io_machines.machines.processes.listList processes running on a machineread
  • fly_io_machines.machines.restartRestart a machinedestructive
  • fly_io_machines.machines.signalSend a signal to a machinewrite
  • fly_io_machines.machines.startStart a machinewrite
  • fly_io_machines.machines.stopStop a machinewrite
  • fly_io_machines.machines.suspendSuspend a machinewrite
  • fly_io_machines.machines.uncordonUncordon a machine (resume routing traffic)write
  • fly_io_machines.machines.updateUpdate a machine's configurationwrite
  • fly_io_machines.machines.versions.listList a machine's config versionsread
  • fly_io_machines.machines.waitWait for a machine to reach a stateread
Postgres25
  • fly_io_machines.postgres.attachments.createAttach a Managed Postgres cluster to an appwrite
  • fly_io_machines.postgres.attachments.deleteDetach a Managed Postgres cluster from an appdestructive
  • fly_io_machines.postgres.backups.createStart a cluster backupwrite
  • fly_io_machines.postgres.backups.listList a cluster's backupsread
  • fly_io_machines.postgres.createCreate a Managed Postgres clusterwrite
  • fly_io_machines.postgres.databases.createCreate a database in a clusterwrite
  • fly_io_machines.postgres.databases.deleteDelete a database from a clusterdestructive
  • fly_io_machines.postgres.databases.listList a cluster's databasesread
  • fly_io_machines.postgres.deleteDelete a Managed Postgres clusterdestructive
  • fly_io_machines.postgres.extensions.disableDisable an extension on a databasedestructive
  • fly_io_machines.postgres.extensions.enableEnable an extension on a databasewrite
  • fly_io_machines.postgres.extensions.listList a database's extensionsread
  • fly_io_machines.postgres.forkFork a clusterwrite
  • fly_io_machines.postgres.getGet a Managed Postgres clusterread
  • fly_io_machines.postgres.listList Managed Postgres clustersread
  • fly_io_machines.postgres.plans.listList Managed Postgres plansread
  • fly_io_machines.postgres.queries.active.listList a cluster's active queriesread
  • fly_io_machines.postgres.queries.slow.listList a cluster's slow queriesread
  • fly_io_machines.postgres.restoreRestore a cluster into a new clusterwrite
  • fly_io_machines.postgres.users.createCreate a cluster userwrite
  • fly_io_machines.postgres.users.credentials.getGet a cluster user's credentialsread
  • fly_io_machines.postgres.users.deleteDelete a cluster userdestructive
  • fly_io_machines.postgres.users.listList a cluster's usersread
  • fly_io_machines.postgres.users.rotate_passwordRotate a cluster user's passworddestructive
  • fly_io_machines.postgres.users.updateChange a cluster user's rolewrite
Secret keys9
  • fly_io_machines.secret_keys.decryptDecrypt ciphertext with an app secret keyread
  • fly_io_machines.secret_keys.deleteDelete an app secret keydestructive
  • fly_io_machines.secret_keys.encryptEncrypt plaintext with an app secret keyread
  • fly_io_machines.secret_keys.generateGenerate a random app secret keywrite
  • fly_io_machines.secret_keys.getGet an app secret keyread
  • fly_io_machines.secret_keys.listList an app's secret keysread
  • fly_io_machines.secret_keys.setCreate or replace an app secret keywrite
  • fly_io_machines.secret_keys.signSign plaintext with an app secret keyread
  • fly_io_machines.secret_keys.verifyVerify a signature with an app secret keyread
Certificates8
  • fly_io_machines.certificates.acme.createRequest an ACME (Let's Encrypt) certificatewrite
  • fly_io_machines.certificates.acme.deleteRemove a hostname's ACME certificatesdestructive
  • fly_io_machines.certificates.checkCheck a certificate's DNS and trigger validationwrite
  • fly_io_machines.certificates.custom.createUpload a custom certificatewrite
  • fly_io_machines.certificates.custom.deleteRemove a hostname's custom certificatedestructive
  • fly_io_machines.certificates.deleteRemove a hostname and all its certificatesdestructive
  • fly_io_machines.certificates.getGet a certificate for a hostnameread
  • fly_io_machines.certificates.listList an app's certificatesread
Volumes8
  • fly_io_machines.volumes.createCreate a volumewrite
  • fly_io_machines.volumes.deleteDestroy a volumedestructive
  • fly_io_machines.volumes.extendExtend a volume's sizewrite
  • fly_io_machines.volumes.getGet a volumeread
  • fly_io_machines.volumes.listList an app's volumesread
  • fly_io_machines.volumes.snapshots.createCreate a volume snapshotwrite
  • fly_io_machines.volumes.snapshots.listList a volume's snapshotsread
  • fly_io_machines.volumes.updateUpdate a volumewrite
Apps5
  • fly_io_machines.apps.createCreate an appwrite
  • fly_io_machines.apps.deleteDelete an appdestructive
  • fly_io_machines.apps.deploy_token.createCreate a deploy token for an appwrite
  • fly_io_machines.apps.getGet an appread
  • fly_io_machines.apps.listList apps in an organizationread
Secrets5
  • fly_io_machines.secrets.deleteDelete an app secretdestructive
  • fly_io_machines.secrets.getGet an app secretread
  • fly_io_machines.secrets.listList an app's secretsread
  • fly_io_machines.secrets.setCreate or replace an app secretwrite
  • fly_io_machines.secrets.updateSet or unset several app secretswrite
Ip assignments3
  • fly_io_machines.ip_assignments.createAllocate an IP address to an appwrite
  • fly_io_machines.ip_assignments.deleteRelease an app's IP addressdestructive
  • fly_io_machines.ip_assignments.listList an app's IP addressesread
Tokens3
  • fly_io_machines.tokens.authenticateAuthenticate a Fly token and list its permissionsread
  • fly_io_machines.tokens.authorizeCheck whether a Fly token grants an accessread
  • fly_io_machines.tokens.current.getGet the current token's detailsread
Platform2
  • fly_io_machines.platform.placements.queryGet recommended regions for machine placementread
  • fly_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.