# Fly.io MCP for AI Agents AI Agent Connect > Fly.io MCP lets you manage your cloud infrastructure through any AI agent. You can provision resources, control machine lifecycles, and manage persistent volumes without switching tabs. It gives your agent full access to the Fly Machines API to handle global deployments, app management, and security certificates directly from your chat interface. ## Overview - **Category:** ship-it - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_TOLbpqnr8s2f7QW5APvNRnPAwfWm5UUznYMW7th5/ai-agent-connect - **Tags:** fly-io, cloud-computing, infrastructure-as-code, paas, serverless-machines ## Description Managing cloud infrastructure usually involves a tedious cycle of opening a browser, navigating to a dashboard, searching for a specific app, and then hunting through nested menus to find the right button. You might have to copy IDs from one tab to another just to update a machine configuration or check if a volume is ready. It's a lot of friction for tasks that should take seconds. This Connector removes that friction by letting you talk to your Fly.io environment in plain English. Instead of hunting for the right command to scale a machine or resize a volume, you just tell your agent what needs to happen. It handles the heavy lifting of interacting with the Fly Machines API for you. Whether you're spinning up new apps, managing persistent storage, or handling OIDC tokens for secure workloads, you can do it all from your existing workspace. It's part of the Vinkius catalog, making it easy to plug into your current workflow. You get a direct line to your global deployments, allowing you to monitor machine states and update configurations on the fly. It turns your AI agent into a capable infrastructure operator that knows your specific app layout and requirements. ## Tools ### extend_volume Increases the size of an existing volume. It's the easiest way to scale your storage on the fly. ### start_machine Starts a Machine that is currently stopped. Use this to bring your compute back online. ### delete_app Deletes a Fly App from your organization. Use this to clean up old projects and free up space. ### delete_certificate Removes a hostname and its associated certificates. It helps keep your app's security profile clean. ### delete_machine Deletes a specific Machine. This is how you remove compute resources you no longer need. ### delete_volume Deletes a volume. Use this to free up storage space in your app. ### get_app Retrieves details about a specific Fly App. Use this to check your app's current configuration. ### get_certificate Fetches the details of a specific certificate. It helps you verify your SSL status. ### get_machine Gets the specific details of a Machine. Use this to check its current status and metadata. ### get_volume Retrieves details about a specific volume. Use this to check storage limits and IDs. ### request_oidc_token Requests an OpenID Connect token. It's used for secure workload identity. ### create_lease Creates a lease for a specific Machine. Use this to reserve resources for your workloads. ### create_machine Creates a new Fly Machine using a config object like the image. This is the primary way to spin up new compute. ### create_volume Creates a new persistent volume. This is essential for stateful applications that need to save data. ### list_apps Lists all Fly Apps in your account. It gives you a bird's-eye view of your projects. ### list_certificates Lists all certificates for a specific app. Use this to audit your app's security. ### list_machines Lists all Machines within a specific app. It helps you see what's currently running. ### list_volume_snapshots Lists all available volume snapshots. Use this to find specific data points for restoration. ### list_volumes Lists all volumes associated with an app. It's the first step to managing your storage. ### release_lease Releases a lease for a Machine. Use this to free up reserved resources. ### stop_machine Stops a Machine. Use this to pause compute costs when your app isn't in use. ### suspend_machine Suspends a Machine. This is a middle ground between starting and stopping. ### update_machine Updates the configuration of an existing Machine. Use this to change environment variables or images. ### wait_machine Waits for a specific Machine to reach a desired state. This is great for automation scripts. ### check_certificate Triggers a DNS validation check for a certificate. Use this to debug SSL issues. ### create_acme_certificate Requests a new Let's Encrypt certificate. It's the standard way to get free SSL. ### create_app Creates a new Fly App. This is your starting point for a new deployment. ### create_custom_certificate Imports a custom PEM certificate. Use this when you have your own SSL credentials. ## Prompt Examples **Prompt:** ``` List all my Fly.io apps in the 'dev' organization. ``` **Response:** ``` I've found 3 apps in the 'dev' organization: **auth-service**, **payment-gateway**, and **user-profile**. Which one would you like to look into? ``` **Prompt:** ``` Start the machine with ID 9185210b6e4d8p in the app 'auth-service'. ``` **Response:** ``` Starting machine 9185210b6e4d8p... ✅ **Success**: The request was successful. The machine is now transitioning to the **started** state. Let me know if you need me to check anything else. ``` **Prompt:** ``` Create a 50GB volume named 'log_storage' in the 'ams' region for app 'payment-gateway'. ``` **Response:** ``` I've initiated the creation of a 50GB volume **'log_storage'** in Amsterdam (ams) for **'payment-gateway'**. - **Volume ID**: `vol_x892k1m2l` - **Status**: Ready to be attached to a machine. ``` ## Capabilities ### Provision new Fly Apps Create and manage app instances across your organization. ### Control machine states Start, stop, suspend, and update machines with specific configurations. ### Manage persistent storage Create, extend, and list volumes and snapshots for stateful data. ### Handle security certificates Request ACME certificates and manage custom PEM imports. ### Request OIDC tokens Secure your workload identity by requesting tokens directly. ### Monitor infrastructure Wait for specific machine states and fetch metadata for debugging. ## Use Cases ### Scaling storage on the fly A developer needs more space for a database. They ask the agent to use extend_volume to add 20GB to their 'db-primary' volume. ### Emergency machine restarts An SRE notices a failing node. They ask the agent to stop_machine and start_machine on a healthy instance to restore service. ### New app deployment A dev wants to launch a new API. They tell the agent to create_app and then create_machine with a specific image. ### Certificate debugging A site is showing SSL errors. The user asks the agent to check_certificate and then create_acme_certificate to fix the issue. ## Benefits - Stop switching tabs between your terminal and the Fly dashboard by using list_apps and get_machine directly in your chat. - Scale your storage on demand with extend_volume without having to manually edit configuration files or wait for manual provisioning. - Handle complex machine lifecycles like suspend_machine and start_machine to manage your costs and availability instantly. - Automate your security workflow by using create_acme_certificate and request_oidc_token to keep your workloads secure. - Debug your deployment faster by using wait_machine to ensure resources are ready before your agent proceeds with the next step. - Keep your environment clean by using delete_app and delete_volume to prune old resources with simple voice or text commands. ## How It Works The bottom line is you get a natural language interface for your entire Fly.io infrastructure. 1. Subscribe to the Fly.io MCP and grab your Personal Access Token from the Fly dashboard. 2. Input the token into your AI client to link your account. 3. Ask your agent to list apps, start machines, or manage volumes to see the connection in action. ## Frequently Asked Questions **Can the Fly.io MCP manage my volumes?** Yes, you can create, list, and even extend volumes for your stateful applications. This lets you handle storage scaling through your AI agent. **Does this Connector support certificate management?** It does. You can request new Let's Encrypt certificates, check DNS validation, and even import custom PEM certificates. **How do I use the Fly.io MCP to manage my machines?** You can tell your agent to start, stop, suspend, or update machine configurations. It's a way to control your compute resources using plain English. **Can I use the Fly.io MCP to check my app status?** Definitely. You can ask your agent to list your apps or get specific details about any Fly App to see what's running. **Does the Fly.io MCP work with my existing Fly.io account?** Yes, it connects to your account using a Personal Access Token so it can perform actions on your behalf. **Can I use this Connector to request security tokens?** Yes, it can request OIDC tokens, which is helpful for managing secure workload identities in your infrastructure. **Can I start or stop a specific Fly Machine using this server?** Yes. You can use the `start_machine` and `stop_machine` tools by providing the app name and the specific Machine ID. You can also use `suspend_machine` for compatible workloads. **How do I create a new application in a specific organization?** Use the `create_app` tool. You will need to provide a unique `app_name` and the `org_slug` of the target organization where you want the app to be provisioned. **Is it possible to manage persistent storage volumes?** Absolutely. The server includes tools like `create_volume`, `list_volumes`, `extend_volume`, and `delete_volume` to handle the full lifecycle of your Fly Volumes.