# shotfleet

> shotfleet is an open-source MCP server for developer tools. Capture and check localized App Store and Google Play screenshots from your agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, CLI
- **Website:** https://shotfleet.com
- **Repository:** https://github.com/noloman/shotfleet-skills
- **MCP Registry name:** com.shotfleet/shotfleet
- **Categories:** developer tools
- **Listing updated:** 2026-11-15

## About

shotfleet is a free, MIT-licensed command-line tool for Apple silicon Macs. From one English Maestro flow it rewrites each tap selector using the translations compiled into your build, runs the flow per language on iOS and Android, then reads every screenshot back and compares its text with your app's strings to catch wrong-language captures.

The MCP server runs locally with `shotfleet mcp`. Config commands in your file do not run over MCP unless the call passes hooks: true. The author reports a run of 18 languages by 4 screens taking 9 minutes on iOS and 15 on Android on an M1 Pro. It makes raw screenshots only: no frames, captions or store upload.

## Features

- **One flow, many languages:** Selectors are rewritten from your app's own strings.
- **Language verification:** Checks each screenshot shows the right language.
- **Both platforms:** iOS and Android, including iPad and tablet sizes.
- **Fastlane export:** Passing screenshots go into fastlane folders.
- **Local only:** The app and screenshots are never uploaded.

## Good for

- Produce store screenshots in every supported language
- Catch a screenshot captured in the wrong language
- Add a screenshot check to CI
- Find layouts that break in long-text languages

## Install

### Claude Code (Terminal)

```sh
claude mcp add shotfleet -- npx -y https://github.com/noloman/shotfleet-skills/releases/download/mcpb-v0.1.9/shotfleet.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "shotfleet": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/noloman/shotfleet-skills/releases/download/mcpb-v0.1.9/shotfleet.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "shotfleet": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/noloman/shotfleet-skills/releases/download/mcpb-v0.1.9/shotfleet.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "shotfleet": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/noloman/shotfleet-skills/releases/download/mcpb-v0.1.9/shotfleet.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "shotfleet": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/noloman/shotfleet-skills/releases/download/mcpb-v0.1.9/shotfleet.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "shotfleet": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/noloman/shotfleet-skills/releases/download/mcpb-v0.1.9/shotfleet.mcpb"
      ]
    }
  }
}
```

## Tools

- `check`: Checks a folder of screenshots for language, duplicates, missing items and store size and count rules.
- `doctor`: Reports whether Maestro, Xcode and the Android SDK are ready; changes nothing.
- `run`: Captures screenshots in every language from a shotfleet.toml, then checks them.

## FAQ

### Which Macs work?

Apple silicon Macs only.

### What does it need?

Maestro and Java 17+, unless you use your own XCUITest screenshot tests on iOS.

### Does it add frames or upload?

No.

### Does it need an account?

No account, key or license server.

### Is shotfleet free?

Yes. shotfleet is open source, so you can use and self-host it for free.

### How do I add shotfleet to Claude Code?

Run this command in your terminal: claude mcp add shotfleet -- npx -y https://github.com/noloman/shotfleet-skills/releases/download/mcpb-v0.1.9/shotfleet.mcpb

### What are the best alternatives to shotfleet?

The closest alternatives to shotfleet are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/shotfleet
