Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to the Fly.io MCP server

Vendor MCP
Open markdown

The Fly.io MCP connector routes your AI agent's tool calls to Fly.io's own MCP server through Scalekit. Each user signs in to Fly.io once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 47 tools.

Tools
47
What they doRead · write · destructive
27 · 7 · 1327 read7 write13 destructive
Users sign in with
OAuth app
Your own Fly.io MCP server app

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Fly.io MCP connection

    In AgentKit > Connections, create a Fly.io MCP connection and copy its redirect URI. The name you give it is the connection_name your code passes. See Configure connections.

  4. Register an OAuth app

    Fly.io MCP server connections use your own OAuth app. Register one with Fly.io MCP server and add the redirect URI you copied.

    Then enter the app's Client ID and Client Secret on the Fly.io MCP connection.

  5. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'flymcp'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Fly.io MCP:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'flymcp_get_fly_context',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user signs in once. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • flymcp_checkpoint_getGet details of a specific checkpoint.Read-only

    Get Sprite checkpoint

    Get details of a specific checkpoint.

    Inputs

    checkpoint_idstringrequired
    Checkpoint id
    spritestringrequired
    Name of the sprite to target.
    sprite_idstring
    Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
  • flymcp_checkpoint_listList all checkpoints.Read-only

    List Sprite checkpoints

    List all checkpoints.

    Inputs

    spritestringrequired
    Name of the sprite to target.
    sprite_idstring
    Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
  • flymcp_exec_listList active exec sessions.Read-only

    List Sprite commands

    List active exec sessions.

    Inputs

    spritestringrequired
    Name of the sprite to target.
    sprite_idstring
    Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
  • flymcp_file_listList directory contents.Read-only

    List Sprite files

    List directory contents.

    Inputs

    pathstringrequired
    Path to the directory to list
    spritestringrequired
    Name of the sprite to target.
    sprite_idstring
    Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
    workingDirstring
    Base directory for relative paths. Defaults to /home/sprite; absolute paths are unaffected.default /home/sprite
  • flymcp_file_readRead file contents from the sprite filesystem.Read-only

    Read Sprite file

    Read file contents from the sprite filesystem. Returns raw file bytes.

    Inputs

    pathstringrequired
    Path to the file to read
    spritestringrequired
    Name of the sprite to target.
    encodingstring
    Content encoding for the file read. Use utf8 (the default) for an MCP embedded text resource, or base64 for an MCP embedded binary resource with a base64 blob.one of utf8base64default utf8
    sprite_idstring
    Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
    workingDirstring
    Base directory for relative paths. Defaults to /home/sprite; absolute paths are unaffected.default /home/sprite
  • flymcp_get_credit_balanceRead the selected organization's purchased credit balance in US cents, the Purchased Credit Balance on its billing page.Read-only

    Get purchased credit balance

    Read the selected organization's purchased credit balance in US cents, the Purchased Credit Balance on its billing page. Trial credits and other grants are not included. For an organization billed through a parent organization, purchased_credit_balance_cents is null and billed_by_parent is true. Does not buy credits or alter payment settings.

    Inputs

    org_slugstringrequired
    No description.
  • flymcp_get_fly_contextShow this connection's current authorized resource bindings, per-resource scopes, and restrictions, including the Sprites name_prefix and max_sprites_total creation limit.Read-only

    Get fly context

    Show this connection's current authorized resource bindings, per-resource scopes, and restrictions, including the Sprites name_prefix and max_sprites_total creation limit. This describes the grant and never expands access.

    Inputs

    This tool takes no inputs.

  • flymcp_get_launch_requirementsExplain launch blockers and return browser handoffs for billing, SSO or provider terms.Read-only

    Get launch requirements

    Explain launch blockers and return browser handoffs for billing, SSO or provider terms. Does not accept terms or alter payment settings.

    Inputs

    org_slugstringrequired
    No description.