> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to the Fly.io MCP server

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.

**Authentication:** OAuth 2.1/DCR
**Categories:** Developer Tools
**Tools:** 47: 27 read, 7 write, 13 destructive
**Users sign in with:** OAuth
**OAuth app:** Your own Fly.io MCP server app
**Built by:** Vendor MCP
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=FLYMCP)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".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](/agentkit/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

   **Node.js** (`quickstart.mts`)

   ```typescript
   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)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "flymcp"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Fly.io MCP:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="flymcp_get_fly_context",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user signs in once. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'flymcp_checkpoint_get',
  toolInput: {
    checkpoint_id: '<checkpoint_id>',
    sprite: '<sprite>',
  },
  connector: 'flymcp',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="flymcp_checkpoint_get",
    tool_input={
        "checkpoint_id": "<checkpoint_id>",
        "sprite": "<sprite>",
    },
    connection_name="flymcp",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `flymcp_checkpoint_get`

Get Sprite checkpoint · Read-only

Get details of a specific checkpoint.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `checkpoint_id` (`string`, required): Checkpoint id
- `sprite` (`string`, required): Name of the sprite to target.
- `sprite_id` (`string`, optional): Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.

Example input: `{"checkpoint_id":"<checkpoint_id>","sprite":"<sprite>"}`

### `flymcp_checkpoint_list`

List Sprite checkpoints · Read-only

List all checkpoints.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `sprite` (`string`, required): Name of the sprite to target.
- `sprite_id` (`string`, optional): Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.

Example input: `{"sprite":"<sprite>"}`

### `flymcp_exec_list`

List Sprite commands · Read-only

List active exec sessions.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `sprite` (`string`, required): Name of the sprite to target.
- `sprite_id` (`string`, optional): Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.

Example input: `{"sprite":"<sprite>"}`

### `flymcp_file_list`

List Sprite files · Read-only

List directory contents.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `path` (`string`, required): Path to the directory to list
- `sprite` (`string`, required): Name of the sprite to target.
- `sprite_id` (`string`, optional): Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
- `workingDir` (`string`, optional): Base directory for relative paths. Defaults to /home/sprite; absolute paths are unaffected. Default: `/home/sprite`.

Example input: `{"path":"<path>","sprite":"<sprite>"}`

### `flymcp_file_read`

Read Sprite file · Read-only

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

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `path` (`string`, required): Path to the file to read
- `sprite` (`string`, required): Name of the sprite to target.
- `encoding` (`string`, optional): 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: `utf8`, `base64`. Default: `utf8`.
- `sprite_id` (`string`, optional): Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
- `workingDir` (`string`, optional): Base directory for relative paths. Defaults to /home/sprite; absolute paths are unaffected. Default: `/home/sprite`.

Example input: `{"path":"<path>","sprite":"<sprite>"}`

### `flymcp_get_credit_balance`

Get purchased credit balance · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `org_slug` (`string`, required): No description.

Example input: `{"org_slug":"<org_slug>"}`

### `flymcp_get_fly_context`

Get fly context · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `flymcp_get_launch_requirements`

Get launch requirements · Read-only

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

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `org_slug` (`string`, required): No description.

Example input: `{"org_slug":"<org_slug>"}`

### `flymcp_get_organization`

Get organization · Read-only

Read the selected organization's identity, current role and launch eligibility.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `org_slug` (`string`, required): No description.

Example input: `{"org_slug":"<org_slug>"}`

### `flymcp_get_postgres_cluster`

Get Managed Postgres cluster · Read-only

Get details of a specific Managed Postgres cluster, including its status and, once it is ready, its endpoints.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `org_slug` (`string`, required): The concrete Fly organization slug; the personal alias is not accepted.
- `postgres_cluster_id` (`string`, required): Managed Postgres Cluster ID

Example input: `{"org_slug":"<org_slug>","postgres_cluster_id":"<postgres_cluster_id>"}`

### `flymcp_get_postgres_plans`

Get Managed Postgres plans · Read-only

List the Managed Postgres plans available when creating or forking a cluster in an organization, cheapest first.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `org_slug` (`string`, required): The concrete Fly organization slug; the personal alias is not accepted.

Example input: `{"org_slug":"<org_slug>"}`

### `flymcp_get_sprite_info`

Get Sprite Info · Read-only

Read authorized Sprite metadata without waking it. Pass sprite_id from a mention or Inspector selection to reject deleted and recreated environments.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `sprite` (`string`, required): No description.
- `sprite_id` (`string`, optional): No description.

Example input: `{"sprite":"<sprite>"}`

### `flymcp_list_organizations`

List organizations · Read-only

List current organization identities and roles under explicitly granted account-directory access. This does not authorize their resources.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `flymcp_list_postgres_active_queries`

List Managed Postgres active queries · Read-only

List active queries in the supplied database. Returns full query text and durations in seconds.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `database` (`string`, required): Database to inspect
- `org_slug` (`string`, required): The concrete Fly organization slug; the personal alias is not accepted.
- `postgres_cluster_id` (`string`, required): Managed Postgres Cluster ID

Example input: `{"database":"<database>","org_slug":"<org_slug>","postgres_cluster_id":"<postgres_cluster_id>"}`

### `flymcp_list_postgres_backups`

List Managed Postgres backups · Read-only

List all backups associated with a specific cluster.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `org_slug` (`string`, required): The concrete Fly organization slug; the personal alias is not accepted.
- `postgres_cluster_id` (`string`, required): Managed Postgres Cluster ID

Example input: `{"org_slug":"<org_slug>","postgres_cluster_id":"<postgres_cluster_id>"}`

### `flymcp_list_postgres_clusters`

List Managed Postgres clusters · Read-only

List Managed Postgres clusters for an organization.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `org_slug` (`string`, required): The concrete Fly organization slug; the personal alias is not accepted.
- `include_deleted` (`boolean`, optional): Include deleted clusters

Example input: `{"org_slug":"<org_slug>"}`

### `flymcp_list_postgres_databases`

List Managed Postgres databases · Read-only

List all databases within a specific cluster.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `org_slug` (`string`, required): The concrete Fly organization slug; the personal alias is not accepted.
- `postgres_cluster_id` (`string`, required): Managed Postgres Cluster ID

Example input: `{"org_slug":"<org_slug>","postgres_cluster_id":"<postgres_cluster_id>"}`

### `flymcp_list_postgres_extensions`

List Managed Postgres extensions · Read-only

List all extensions available within a specific database, indicating which are installed.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `database_name` (`string`, required): Database Name
- `org_slug` (`string`, required): The concrete Fly organization slug; the personal alias is not accepted.
- `postgres_cluster_id` (`string`, required): Managed Postgres Cluster ID

Example input: `{"database_name":"<database_name>","org_slug":"<org_slug>","postgres_cluster_id":"<postgres_cluster_id>"}`

### `flymcp_list_postgres_slow_queries`

List Managed Postgres slow queries · Read-only

List the top 20 queries by cumulative total execution time, excluding the postgres database. Uses the latest available metrics within the lookback range; statistics are cumulative PostgreSQL counters, not deltas over that range. Returns full query text and execution times in seconds.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `org_slug` (`string`, required): The concrete Fly organization slug; the personal alias is not accepted.
- `postgres_cluster_id` (`string`, required): Managed Postgres Cluster ID
- `range` (`integer`, optional): Metrics lookback in seconds. Default: `3600`.

Example input: `{"org_slug":"<org_slug>","postgres_cluster_id":"<postgres_cluster_id>"}`

### `flymcp_list_postgres_users`

List Managed Postgres users · Read-only

List all Postgres users within a specific cluster.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `org_slug` (`string`, required): The concrete Fly organization slug; the personal alias is not accepted.
- `postgres_cluster_id` (`string`, required): Managed Postgres Cluster ID

Example input: `{"org_slug":"<org_slug>","postgres_cluster_id":"<postgres_cluster_id>"}`

### `flymcp_list_sprites`

List Sprites · Read-only

List Sprites visible to this connection. The grant's name prefix and optional label filter access; this is not necessarily every Sprite in the organization, nor limited to Sprites created by this client. Call get_fly_context to inspect the restrictions.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `continuation_token` (`string`, optional): No description.
- `max_results` (`integer`, optional): No description.
- `prefix` (`string`, optional): No description.

Example input: `{}`

### `flymcp_open_sprite_inspector`

Sprite Inspector · Read-only

Open a read-only Sprite Inspector showing environments, services, checkpoints and recent service logs. Opening only lists metadata; runtime reads are explicit and may wake a Sprite.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `continuation_token` (`string`, optional): No description.
- `prefix` (`string`, optional): No description.
- `sprite` (`string`, optional): No description.
- `sprite_id` (`string`, optional): No description.

Example input: `{}`

### `flymcp_policy_network_get`

Get Sprite network policy · Read-only

Read the named Sprite's current network policy rules before preparing a replacement.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `sprite` (`string`, required): Name of the sprite to target.
- `sprite_id` (`string`, optional): Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.

Example input: `{"sprite":"<sprite>"}`

### `flymcp_search_sprite_mentions`

Find Sprites · Read-only

Find up to 20 authorized Sprites by name prefix for composer mentions.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): No description.

Example input: `{"query":"<query>"}`

### `flymcp_service_get`

Get Sprite service · Read-only

Get details of a specific service.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `service_name` (`string`, required): Service name
- `sprite` (`string`, required): Name of the sprite to target.
- `sprite_id` (`string`, optional): Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.

Example input: `{"service_name":"<service_name>","sprite":"<sprite>"}`

### `flymcp_service_list`

List Sprite services · Read-only

List all configured services and their current state.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `sprite` (`string`, required): Name of the sprite to target.
- `sprite_id` (`string`, optional): Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.

Example input: `{"sprite":"<sprite>"}`

### `flymcp_service_logs`

Get Sprite service logs · Read-only

Stream logs for a service.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `service_name` (`string`, required): Service name
- `sprite` (`string`, required): Name of the sprite to target.
- `duration` (`string`, optional): Time to follow new logs (default: `0`, no follow)
- `lines` (`integer`, optional): Number of lines to return from log buffer (default: all)
- `sprite_id` (`string`, optional): Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.

Example input: `{"service_name":"<service_name>","sprite":"<sprite>"}`

### `flymcp_checkpoint_create`

Create Sprite checkpoint · Write

Create a new checkpoint of the current sprite state. Returns streaming NDJSON progress.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `sprite` (`string`, required): Name of the sprite to target.
- `comment` (`string`, optional): No description.
- `sprite_id` (`string`, optional): Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.

Example input: `{"sprite":"<sprite>"}`

### `flymcp_create_postgres_backup`

Create Managed Postgres backup · Write

Create a backup for a specific cluster. The backup runs asynchronously and is rejected if one is already in progress.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `body` (`object`, required): No description.
- `org_slug` (`string`, required): The concrete Fly organization slug; the personal alias is not accepted.
- `postgres_cluster_id` (`string`, required): Managed Postgres Cluster ID

Example input: `{"body":{},"org_slug":"<org_slug>","postgres_cluster_id":"<postgres_cluster_id>"}`

### `flymcp_create_postgres_cluster`

Create Managed Postgres cluster · Write

Create a Managed Postgres cluster in the organization. Provisioning is asynchronous: poll get_postgres_cluster until its status is ready before creating databases or enabling extensions.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `body` (`object`, required): No description.
- `org_slug` (`string`, required): The concrete Fly organization slug; the personal alias is not accepted.

Example input: `{"body":{},"org_slug":"<org_slug>"}`

### `flymcp_create_postgres_database`

Create Managed Postgres database · Write

Create a database within a specific cluster.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `body` (`object`, required): No description.
- `org_slug` (`string`, required): The concrete Fly organization slug; the personal alias is not accepted.
- `postgres_cluster_id` (`string`, required): Managed Postgres Cluster ID

Example input: `{"body":{},"org_slug":"<org_slug>","postgres_cluster_id":"<postgres_cluster_id>"}`

### `flymcp_create_sprite`

Create Sprite · Write

Create a Sprite within this connection's grant restrictions. First call get_fly_context and inspect the Sprites binding restrictions for the required name_prefix and max_sprites_total creation limit.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): No description.
- `wait_for_capacity` (`boolean`, optional): No description.

Example input: `{"name":"<name>"}`

### `flymcp_enable_postgres_extension`

Enable Managed Postgres extension · Write

Enable a Postgres extension within a specific database. PostGIS extensions require a PostGIS-enabled cluster.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `body` (`object`, required): No description.
- `database_name` (`string`, required): Database Name
- `org_slug` (`string`, required): The concrete Fly organization slug; the personal alias is not accepted.
- `postgres_cluster_id` (`string`, required): Managed Postgres Cluster ID

Example input: `{"body":{},"database_name":"<database_name>","org_slug":"<org_slug>","postgres_cluster_id":"<postgres_cluster_id>"}`

### `flymcp_fork_postgres_cluster`

Fork Managed Postgres cluster · Write

Fork a ready Managed Postgres cluster into a new cluster that inherits the source's settings, on the source's plan unless plan is given. The source cluster is left unchanged, and the fork is provisioned asynchronously.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `org_slug` (`string`, required): The concrete Fly organization slug; the personal alias is not accepted.
- `postgres_cluster_id` (`string`, required): Managed Postgres Cluster ID
- `body` (`object`, optional): No description.

Example input: `{"org_slug":"<org_slug>","postgres_cluster_id":"<postgres_cluster_id>"}`

### `flymcp_checkpoint_restore`

Restore Sprite checkpoint · Destructive

Restore to a specific checkpoint. Returns streaming NDJSON progress.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `checkpoint_id` (`string`, required): Checkpoint id
- `sprite` (`string`, required): Name of the sprite to target.
- `sprite_id` (`string`, optional): Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.

Example input: `{"checkpoint_id":"<checkpoint_id>","sprite":"<sprite>"}`

### `flymcp_destroy_sprite`

Destroy Sprite · Destructive

Destroy a sprite in the authenticated organization.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `name` (`string`, required): No description.

Example input: `{"name":"<name>"}`

### `flymcp_exec`

Run command in Sprite · Destructive

Run a command on the named Sprite without a TTY and return its output; interactive commands that need a terminal are not supported. Pass an argv array to preserve argument boundaries; to use shell syntax, explicitly run a shell such as bash -c. Commands can modify files and access the network.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `cmd` (`string`, required): Command to execute. Pass an array of strings (executable then arguments) to keep arguments containing spaces intact; a string is split on whitespace.
- `sprite` (`string`, required): Name of the sprite to target.
- `dir` (`string`, optional): Working directory for the command
- `env` (`string`, optional): Environment variables in `KEY=VALUE` format (can be repeated)
- `path` (`string`, optional): Explicit path to executable (defaults to first `cmd` value or `bash`)
- `sprite_id` (`string`, optional): Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
- `stdin` (`boolean`, optional): Enable stdin from request body (default: `false`)

Example input: `{"cmd":"<cmd>","sprite":"<sprite>"}`

### `flymcp_exec_kill`

Kill Sprite command · Destructive

Kill an exec session by session ID. Returns streaming NDJSON with kill progress.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `session_id` (`string`, required): Session id
- `sprite` (`string`, required): Name of the sprite to target.
- `signal` (`string`, optional): Signal to send (default: `SIGTERM`)
- `sprite_id` (`string`, optional): Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
- `timeout` (`string`, optional): Timeout waiting for process to exit (default: `10s`)

Example input: `{"session_id":"<session_id>","sprite":"<sprite>"}`

### `flymcp_file_copy`

Copy Sprite file · Destructive

Copy a file or directory on the named Sprite. recursive, preserveAttrs and asRoot default to false; enable them explicitly to copy directory trees, preserve attributes or use root privileges.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `dest` (`string`, required): No description.
- `source` (`string`, required): No description.
- `sprite` (`string`, required): Name of the sprite to target.
- `asRoot` (`boolean`, optional): Perform the operation as root. Defaults to false (use the Sprite user). Default: `false`.
- `preserveAttrs` (`boolean`, optional): Preserve file attributes when copying. Defaults to false. Default: `false`.
- `recursive` (`boolean`, optional): Operate recursively on directory contents. Defaults to false. Default: `false`.
- `sprite_id` (`string`, optional): Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
- `workingDir` (`string`, optional): Base directory for relative paths. Defaults to /home/sprite; absolute paths are unaffected. Default: `/home/sprite`.

Example input: `{"dest":"<dest>","source":"<source>","sprite":"<sprite>"}`

### `flymcp_file_delete`

Delete Sprite file · Destructive

Delete a file or directory on the named Sprite. recursive defaults to false; set it to true explicitly to delete a directory tree. asRoot defaults to false.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `path` (`string`, required): No description.
- `sprite` (`string`, required): Name of the sprite to target.
- `asRoot` (`boolean`, optional): Perform the operation as root. Defaults to false (use the Sprite user). Default: `false`.
- `recursive` (`boolean`, optional): Operate recursively on directory contents. Defaults to false. Default: `false`.
- `sprite_id` (`string`, optional): Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
- `workingDir` (`string`, optional): Base directory for relative paths. Defaults to /home/sprite; absolute paths are unaffected. Default: `/home/sprite`.

Example input: `{"path":"<path>","sprite":"<sprite>"}`

### `flymcp_file_rename`

Rename Sprite file · Destructive

Rename or move a file or directory on the named Sprite. asRoot defaults to false.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `dest` (`string`, required): No description.
- `source` (`string`, required): No description.
- `sprite` (`string`, required): Name of the sprite to target.
- `asRoot` (`boolean`, optional): Perform the operation as root. Defaults to false (use the Sprite user). Default: `false`.
- `sprite_id` (`string`, optional): Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
- `workingDir` (`string`, optional): Base directory for relative paths. Defaults to /home/sprite; absolute paths are unaffected. Default: `/home/sprite`.

Example input: `{"dest":"<dest>","source":"<source>","sprite":"<sprite>"}`

### `flymcp_file_write`

Write Sprite file · Destructive

Write up to 16 MiB of file contents to the sprite filesystem. Request body contains raw file bytes.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `content` (`string`, required): For utf8, the literal text to write. For base64, RFC 4648 base64-encoded bytes without a data URL prefix; the server decodes them before writing.
- `path` (`string`, required): Path to the file to write
- `sprite` (`string`, required): Name of the sprite to target.
- `encoding` (`string`, optional): Content encoding for the file write. Use utf8 (the default) for literal text, or base64 when content contains RFC 4648 base64-encoded bytes without a data URL prefix. One of: `utf8`, `base64`. Default: `utf8`.
- `mkdir` (`boolean`, optional): Create parent directories if they don't exist
- `mode` (`string`, optional): File permissions in octal (e.g., '0644')
- `sprite_id` (`string`, optional): Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
- `workingDir` (`string`, optional): Base directory for relative paths. Defaults to /home/sprite; absolute paths are unaffected. Default: `/home/sprite`.

Example input: `{"content":"<content>","path":"<path>","sprite":"<sprite>"}`

### `flymcp_policy_network_update`

Update Sprite network policy · Destructive

Replace the named Sprite's entire network policy with the supplied rules; this does not append rules. Read policy_network_get first and include every rule to retain. Replacement can interrupt network access and running work.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `rules` (`array`, required): List of network policy rules
- `sprite` (`string`, required): Name of the sprite to target.
- `sprite_id` (`string`, optional): Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.

Example input: `{"rules":[],"sprite":"<sprite>"}`

### `flymcp_service_create`

Create Sprite service · Destructive

Register a named service on the Sprite. On provider-backed Sprites, creates or replaces the stored service definition; use service_start and service_logs for explicit runtime control and output. On legacy Sprites, a new service starts with its dependencies and streams initial logs (duration defaults to 5s). An existing legacy service with the same cmd succeeds without changing any settings; a different cmd conflicts. Read service_get before reusing a name and verify the definition afterward.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `args` (`array`, required): Command arguments
- `cmd` (`string`, required): Command to execute
- `needs` (`array`, required): Service dependencies (started first)
- `service_name` (`string`, required): Service name
- `sprite` (`string`, required): Name of the sprite to target.
- `duration` (`string`, optional): Legacy Sprites only: time to monitor initial logs after starting a new service (default: `5s`). Provider-backed Sprites do not use this to monitor logs.
- `http_port` (`integer`, optional): HTTP port for proxy routing
- `sprite_id` (`string`, optional): Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.

Example input: `{"args":[],"cmd":"<cmd>","needs":[],"service_name":"<service_name>","sprite":"<sprite>"}`

### `flymcp_service_start`

Start Sprite service · Destructive

Start a service. Returns streaming NDJSON with stdout/stderr.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `service_name` (`string`, required): Service name
- `sprite` (`string`, required): Name of the sprite to target.
- `duration` (`string`, optional): Time to monitor logs after starting (default: `5s`)
- `sprite_id` (`string`, optional): Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.

Example input: `{"service_name":"<service_name>","sprite":"<sprite>"}`

### `flymcp_service_stop`

Stop Sprite service · Destructive

Stop a running service. Returns streaming NDJSON with service stop progress.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `service_name` (`string`, required): Service name
- `sprite` (`string`, required): Name of the sprite to target.
- `sprite_id` (`string`, optional): Expected Sprite ID from a mention or Inspector. Rejects a deleted and recreated Sprite with the same name.
- `timeout` (`string`, optional): Timeout waiting for service to stop (default: `10s`)

Example input: `{"service_name":"<service_name>","sprite":"<sprite>"}`

### `flymcp_submit_feedback`

Submit feedback to Fly.io · Destructive

Send the Fly.io team a report about a Fly.io platform bug, a documentation problem or a missing feature you hit while working. Cite what it is about with request_id, url or tool. Reporting the same request_id again returns the original report. Fly.io staff read every report. Do not report errors in the user's own application, and never include secrets, tokens, credentials or customer data.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `category` (`string`, required): bug: Fly.io behaved wrongly. documentation: docs or tool descriptions disagree with behaviour. feature_request: something you needed is not possible. other: anything else. One of: `bug`, `documentation`, `feature_request`, `other`.
- `note` (`string`, required): What happened, what you expected, and what you were trying to do. Never include secrets, tokens, credentials or customer data.
- `org_slug` (`string`, required): An organization this connection is authorized for (see get_fly_context). The report is filed under it.
- `request_id` (`string`, optional): The request ID of the call this is about: the io.fly/request_id value in that tool result's _meta, or a fly-request-id response header.
- `tool` (`string`, optional): The name of the Fly MCP tool this is about, when you have no request ID.
- `url` (`string`, optional): A page this is about, such as a Fly.io docs page.

Example input: `{"category":"bug","note":"<note>","org_slug":"<org_slug>"}`

## Related

Other Developer Tools connectors ([all 200](/agentkit/connectors/?category=developer-tools)):

- [GitHub](/agentkit/connectors/github/): Scalekit connector, OAuth, 217 tools
- [Datadog](/agentkit/connectors/datadog/): Scalekit connector, API key, 105 tools
- [Linear](/agentkit/connectors/linear/): Scalekit connector, OAuth, 64 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
