Skip to content
appsgit

Fly Io

Fly Io is an MCP server that adds cloud and DevOps tools to AI assistants such as Claude Desktop, Claude Code and Cursor. MCP server for managing Fly.io machines, apps, logs, and Docker images. It has 81 GitHub stars, is released under the MIT license and runs locally with npx -y fly-io-mcp-server.

github.com/pulsemcp/mcp-servers (opens in a new tab)

Install Fly Io

Generated from the server's MCP registry entry. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.json
{
  "mcpServers": {
    "fly-io": {
      "command": "npx",
      "args": [
        "-y",
        "fly-io-mcp-server"
      ],
      "env": {
        "FLY_IO_API_TOKEN": "your-value"
      }
    }
  }
}

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

Claude Code

claude mcp add --env FLY_IO_API_TOKEN=your-value --transport stdio fly-io -- npx -y fly-io-mcp-server

Cursor

.cursor/mcp.json
{
  "mcpServers": {
    "fly-io": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "fly-io-mcp-server"
      ],
      "env": {
        "FLY_IO_API_TOKEN": "your-value"
      }
    }
  }
}

Project file; use ~/.cursor/mcp.json to enable it in every project.

VS Code

.vscode/mcp.json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "fly_io_api_token",
      "description": "FLY_IO_API_TOKEN",
      "password": true
    }
  ],
  "servers": {
    "fly-io": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "fly-io-mcp-server"
      ],
      "env": {
        "FLY_IO_API_TOKEN": "${input:fly_io_api_token}"
      }
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Environment variables

Variables the server reads at startup.

NameRequiredDescription
FLY_IO_API_TOKENsecretYesAPI token for Fly.io authentication.
FLY_IO_APP_NAMENoScope server to a single app (disables app management tools).
ENABLED_TOOLGROUPSNoComma-separated tool groups to enable (readonly, write, admin, apps, machines, logs, ssh, images, registry).
SKIP_HEALTH_CHECKSNoSkip API validation at startup.
DISABLE_DOCKER_CLI_TOOLSNoDisable Docker-based registry tools.

Tools (23)

Parsed from the Tools section of the README; check the repository for the current list.

  • list_apps

    readonly, write, admin

  • get_app

    readonly, write, admin

  • create_app

    write, admin

  • delete_app

    admin

  • list_machines

    readonly, write, admin

  • get_machine

    readonly, write, admin

  • get_machine_events

    readonly, write, admin

  • create_machine

    write, admin

  • update_machine

    write, admin

  • delete_machine

    admin

  • start_machine

    write, admin

  • stop_machine

    write, admin

  • restart_machine

    write, admin

  • suspend_machine

    write, admin

  • wait_machine

    write, admin

  • get_logs

    readonly, write, admin

  • machine_exec

    write, admin

  • show_image

    readonly, write, admin

  • list_releases

    readonly, write, admin

  • update_image

    write, admin

  • push_new_fly_registry_image

    write, admin

  • pull_fly_registry_image

    readonly, write, admin

  • check_fly_registry_image

    readonly, write, admin

About Fly Io

MCP server for managing Fly.io machines and applications. This server provides tools for CRUD operations on Fly.io apps and machines (VMs).

FAQ

Fly Io FAQ

Still curious? Email info@appsgit.com.

What is Fly Io?

Fly Io is an MCP server that adds cloud and DevOps tools to AI assistants such as Claude Desktop, Claude Code and Cursor. MCP server for managing Fly.io machines, apps, logs, and Docker images. It has 81 GitHub stars, is released under the MIT license and runs locally with npx -y fly-io-mcp-server. The source code is at github.com/pulsemcp/mcp-servers.

How do I install the Fly Io MCP server?

Add the command npx -y fly-io-mcp-server to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is Fly Io free?

The server is open source under the MIT license, so running it is free. It needs credentials (FLY_IO_API_TOKEN) for the service it connects to, which may require a paid account.

Is Fly Io actively maintained?

The most recent commit was on Aug 30, 2026. The latest release is monorepo-latest-placeholder@0.0.0, published Jul 3, 2025. appsgit only lists MCP servers with a commit in the last six months and re-checks every server daily.