Fly.io
Deploy and operate Fly Apps, Machines, events, waits, and secrets through the Machines API.
Tools
| Name | Description |
|---|---|
list_appsList Fly Apps in an organization. | List Fly Apps in an organization. |
get_appGet Fly App details by app name. | Get Fly App details by app name. |
list_machinesList Machines for one Fly App with optional filters. | List Machines for one Fly App with optional filters. |
get_machineGet one Fly Machine by app and machine ID. | Get one Fly Machine by app and machine ID. |
create_machineCreate a Fly Machine from an explicit image or full Machine config JSON. Requires exact confirmation. | Create a Fly Machine from an explicit image or full Machine config JSON. Requires exact confirmation. |
start_machineStart one Fly Machine by exact app and machine ID. Requires exact confirmation. | Start one Fly Machine by exact app and machine ID. Requires exact confirmation. |
stop_machineStop one Fly Machine. Requires exact confirmation. | Stop one Fly Machine. Requires exact confirmation. |
restart_machineRestart one Fly Machine. Requires exact confirmation. | Restart one Fly Machine. Requires exact confirmation. |
delete_machineDelete one Fly Machine by exact ID. Requires exact confirmation. | Delete one Fly Machine by exact ID. Requires exact confirmation. |
list_machine_eventsList recent events for one Fly Machine. | List recent events for one Fly Machine. |
wait_for_machineWait for a Fly Machine to reach a state. | Wait for a Fly Machine to reach a state. |
list_secretsList secret names and metadata for a Fly App. | List secret names and metadata for a Fly App. |
set_secretCreate or update one Fly App secret by exact name. | Create or update one Fly App secret by exact name. |
delete_secretDelete one Fly App secret by exact name. Requires exact confirmation. | Delete one Fly App secret by exact name. Requires exact confirmation. |
Triggers
| Name | Description |
|---|---|
machine_state_changedTriggers when a Fly Machine event appears after the last poll. | Triggers when a Fly Machine event appears after the last poll. |
Quick Start
import { WeavzClient } from '@weavz-io/sdk'
const weavz = new WeavzClient({ apiKey: 'wvz_...' })
const result = await weavz.actions.execute('fly-io', 'list_apps', {
workspaceId: '550e8400-e29b-41d4-a716-446655440000',
integrationAlias: 'fly-io',
input: { /* ... */ },
})Related Integrations
Works well with
Frequently Asked Questions
How do I connect Fly.io to my app?
Use Weavz Hosted Connect for API Key authentication. Install the SDK, create a connection through the connect portal or API, then execute tools programmatically.
What tools does Fly.io support?
Fly.io supports 14 tools including List Apps, Get App, List Machines, Get Machine, Create Machine, and more.
Can I use Fly.io with AI agents?
Yes. Add Fly.io to an MCP server in Tool Mode or Code Mode. Code Mode provides 3 meta-tools with on-demand API discovery so agents can compose stateful workflows without loading every action schema up front.
How do I connect Fly.io to ChatGPT or Claude?
Open the Weavz connector setup, sign in, choose a workspace, and add Fly.io as an approved app. ChatGPT, Claude, and other remote MCP clients can then call the scoped Fly.io tools exposed by that workspace.
Does Fly.io work with Claude Code, Cursor, Codex, and local agents?
Yes. Remote and local MCP clients can connect to a Weavz MCP endpoint for the workspace. Local coding agents can also use the Weavz CLI to inspect apps, discover actions, run approved Fly.io work, and execute Code Mode workflows from a terminal.
What can I ask an AI agent to do with Fly.io?
Fly.io exposes 14 tools, including List Apps, Get App, List Machines, Get Machine, Create Machine, and more. Use Weavz to keep credentials scoped, require approval for sensitive work, and audit what the agent did.
Can Fly.io be used in stateful agent workflows?
Yes. Agents can combine Fly.io tools with Filesystem, State KV, Human Gates, input partials, and other workspace integrations while keeping execution scoped to the selected workspace or end user.
What authentication does Fly.io use?
Fly.io uses API Key. Weavz stores credentials securely and uses them for authorized action execution.
How much does the Fly.io integration cost?
The Fly.io integration is included on all Weavz plans including the free tier with 20,000 actions per month. No credit card required.
What triggers does Fly.io support?
Fly.io supports 1 triggers including Machine State Changed.
Connect Fly.io in minutes
Get 20,000 free action executions every month. No credit card required.