The official portable Agent Plugin for Sprites: isolated, persistent cloud development environments that agents can create, operate, checkpoint, and clean up.
The package targets Agent Plugins v1.0.0, currently a Working Draft. It connects compatible clients to the hosted Fly MCP server, which serves the Sprites tools, and bundles Agent Skills for common workflows. There is no local server process to install.
- A Streamable HTTP MCP connection to
https://mcp.fly.io, registered under the server namesprites. - OAuth handled by the installing client.
- Skills for day-to-day Sprites work, focused create/run/service/checkpoint/list/ cleanup workflows, setup diagnostics, and an end-to-end smoke test.
- Safety guidance for destructive operations, public services, secrets, and outbound network policy.
The Fly MCP currently exposes 27 Sprites tools for sprite discovery and
management, command execution, files, checkpoints, services, and network policy.
Depending on what is granted at consent, the same connection can also expose
tools for other Fly.io products (apps, Machines, volumes, secrets, Managed
Postgres); the skills in this package cover Sprites only. The live tools/list
response is authoritative.
Install this repository or directory with a client that supports the Agent
Plugins v1 format. The client discovers plugin.json, the immediate children of
skills/, and mcp.json at fixed locations.
On first MCP use, complete the browser OAuth flow: sign in through Fly.io, select the intended organization, and grant the Sprites permissions. Grant only what you need; the consent screen also offers other Fly.io products. A grant may enforce a sprite-name prefix, creation cap, label, or expiry.
Earlier revisions of this package connected to the Sprites MCP server at
https://sprites.dev/mcp. We are transitioning to the new Fly MCP server, and
the package now connects to it at https://mcp.fly.io. The server name (sprites) and all tool
names are unchanged, so existing permission rules keep working. The two
endpoints hold separate OAuth grants: after updating, every existing user must
complete the browser authorization once more.
Agent Plugins standardizes the package contents, not marketplace distribution, installation UI, or permissions. Follow the installing client's documentation for its current local, Git, workspace, or marketplace install flow.
The Agent Plugins project currently lists VS Code, Cursor, GitHub Copilot,
ChatGPT and Codex, and Kiro as compatible clients. All five load Agent Skills
and speak Streamable HTTP MCP, so the single server entry in mcp.json reaches
every one of them. This package is designed to replace the reusable
skills-and-MCP core of the existing Codex and Cursor packages; marketplace
publication remains a separate client-owned step.
Google's August 2026 announcement says Agents CLI and Data Agent Kit currently support the format and that support is expected in more Google products. It mentions Antigravity as an agent that can consume Agents CLI's skills, but does not identify Antigravity itself as a conforming Agent Plugins client. Keep the existing Antigravity package for its hooks, rules, and native installation until that support is documented and tested.
Grok and Claude Code are likewise not on the current compatible-client list. Keep their existing packages too — the Claude package in particular enforces destructive-operation confirmation through a pre-tool hook, which v1 has no portable equivalent for.
- "List my sprites and recommend the best one for this task."
- "Create an isolated sprite for this repository and run its tests."
- "Checkpoint my
mcp-api-debugsprite, then upgrade its dependencies." - "Start the web app as a service and inspect its logs."
- "Check whether the Sprites plugin is authenticated."
- "Run an end-to-end Sprites smoke test and clean up afterward."
.
├── plugin.json
├── mcp.json
├── skills/
│ ├── sprites/
│ │ ├── SKILL.md
│ │ └── references/
│ ├── sprites-new/
│ ├── sprites-run/
│ ├── sprites-service/
│ ├── sprites-checkpoint/
│ ├── sprites-list/
│ ├── sprites-cleanup/
│ ├── sprites-status/
│ └── sprites-smoke/
├── assets/
├── scripts/
└── tests/
Portable Agent Plugins v1 has no commands, hooks, rules, or arbitrary manifest fields. The focused skills preserve the intent of command-like workflows from older client-specific packages without adding non-standard package structure.
Agent Plugins v1 deliberately leaves OAuth discovery, user interaction, and credential storage to the client. The Fly MCP server supports the OAuth flow expected by modern MCP clients; no token is stored in this repository.
The package does not send Fly-Client-Agent attribution headers. A single
portable package cannot truthfully hard-code one host-agent identity, and v1
does not define header interpolation from client identity. Clients may add their
own truthful attribution outside the portable configuration.
Run the dependency-free validation suite:
python3 -m unittest discover -s tests -v
python3 scripts/check_repository.pyThe tests validate the closed v1 manifests, fixed component locations, skill frontmatter, local links, text hygiene, HTTPS transport, and package-boundary rules. They do not make network calls.
This package consolidates the reusable behavior from the existing Sprites plugins for Codex, Cursor, Antigravity, Grok, and Claude Code. The MCP tool model is checked against the Sprites platform source and the public Fly MCP guide. See migration coverage for the artifact-by-artifact mapping and the client-specific behavior that Agent Plugins v1 cannot carry.
MIT © 2026 Fly.io