How do I install Shotfleet?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Shotfleet need an API key?

No required environment variable is listed on this record.

What transport does Shotfleet use?

Shotfleet runs locally over stdio.

When was Shotfleet last checked?

Last checked 2026-11-08. Capture and check localized App Store and Google Play screenshots from your AI agent.

Shotfleet MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

mcpb https://github.com/noloman/shotfleet-skills/releases/download/mcpb-v0.1.9/shotfleet.mcpb

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add com.shotfleet-shotfleet -- mcpb https://github.com/noloman/shotfleet-skills/releases/download/mcpb-v0.1.9/shotfleet.mcpb

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "com.shotfleet-shotfleet": {4      "command": "mcpb",5      "args": [6        "https://github.com/noloman/shotfleet-skills/releases/download/mcpb-v0.1.9/shotfleet.mcpb"7      ]8    }9  }10}

claude_desktop_config.json

Local · mcpbPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.1.9
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

shotfleet skills

This repo is the agent skills and MCP server config for shotfleet, a macOS command-line tool that captures your App Store and Google Play screenshots in every language your app ships, from one English Maestro flow (or your own XCUITest screenshot tests, since 0.1.6), and checks that each screenshot is really in the right language.

shotfleet itself is a paid, closed-source program with a free tier: check is free, run is free for up to 2 languages. The files here are MIT licensed and contain no shotfleet source; they only tell your AI coding agent how to use it. They match shotfleet 0.1.9.

The skills let your AI coding agent know how to install, set up, run and check shotfleet, and how to read the report:

Skill	What it does
`shotfleet`	the main one: which command to run, exit codes, `--json`, writing the flow, troubleshooting
`shotfleet-review`	turns a check report into a fix list (which language to capture again, and if the fix is in the app or the flow)
`shotfleet-ci`	adds `shotfleet check` to GitHub Actions or another CI

The skills tell your agent what to type. The agent still needs shotfleet itself on your Mac:

curl -fsSL https://shotfleet.com/install.sh | sh

Install

MCP server

After installing shotfleet:

claude mcp add shotfleet -- shotfleet mcp

For any other MCP client, the command is shotfleet mcp (stdio). See the MCP server section below.

Claude Code plugin

In a Claude Code session:

/plugin marketplace add noloman/shotfleet-skills
/plugin install shotfleet@shotfleet

Or from your shell:

claude plugin marketplace add noloman/shotfleet-skills
claude plugin install shotfleet@shotfleet

The plugin brings the three skills and the shotfleet MCP server (shotfleet mcp, with check, run and doctor). The MCP server only starts if shotfleet is installed; without it, /mcp shows it as failed and the skills still work. If you already ran shotfleet skill install, you'll see the skills twice. Remove one copy (~/.claude/skills/shotfleet*).

GitHub Copilot, Codex, Cursor, Gemini CLI and others (gh)

With GitHub CLI 2.90 or newer:

gh skill install noloman/shotfleet-skills --all --scope user

Pick the agent with --agent, for example --agent codex, --agent cursor, --agent gemini-cli or --agent claude-code. Leave out --scope user to install into the current project instead.

Any agent (npx)

npx skills add noloman/shotfleet-skills --skill '*' -g

Gemini CLI

gemini skills install https://github.com/noloman/shotfleet-skills.git --path skills/shotfleet
gemini skills install https://github.com/noloman/shotfleet-skills.git --path skills/shotfleet-review
gemini skills install https://github.com/noloman/shotfleet-skills.git --path skills/shotfleet-ci

Already have shotfleet?

Then you already have the skills too. This copies them where Claude Code, Codex, Cursor, Gemini CLI and Copilot look:

shotfleet skill install

Start a new agent session after any of these, then ask something like "check my fastlane screenshots with shotfleet".

MCP server

shotfleet mcp runs a local stdio MCP server. It needs shotfleet installed on your Mac.

Tool	What it does
`check`	checks a folder of screenshots: each one shows its own language, no copies across languages, none missing, store size and count rules; returns a short summary
`doctor`	says whether Maestro, Xcode and the Android SDK are ready, and what is missing; changes nothing
`run`	captures screenshots in every language from a `shotfleet.toml`, then checks them; boots simulators and emulators, so it takes minutes

Safety: no command written in your config runs over MCP unless the call passes hooks: true. Without it, run skips [hooks] and refuses a config with a [capture] build, [ios] simctl or [android] shell. run always installs and runs the config's app on the simulators, so only point it at a project you trust. check is not read-only: it writes its report (check.json and index.html) to a report folder, and never changes a screenshot.

Price

The skills are free, MIT licensed. In shotfleet, check is free and run is free for up to 2 languages. run beyond 2 languages and export need a licence: shotfleet.com.

Your licence key

Never paste your licence key into an agent config, a chat, an MCP setting or a repo. Run this once yourself, in your own terminal:

shotfleet activate <your key>

After that your agent uses shotfleet and never sees the key. In CI, put the key in a secret called SHOTFLEET_KEY. Don't pass it with claude mcp add --env: it would end up in plain text in ~/.claude.json.

Questions

Write to me at [email protected]. The files here are copied from the shotfleet source at each release, see SYNC.md.

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Shotfleet?

Does Shotfleet need an API key?

What transport does Shotfleet use?

When was Shotfleet last checked?

Documentation

shotfleet skills

Install

MCP server

Claude Code plugin

GitHub Copilot, Codex, Cursor, Gemini CLI and others (gh)

Any agent (npx)

Gemini CLI

Already have shotfleet?

MCP server

Price

Your licence key

Questions