getstoreready-mcp

Two ways to connect

A. Hosted connector (no install)

Add https://api.getstoreready.com/mcp as a custom connector / remote MCP server. The first time, your AI app opens getstoreready.com — sign up or log in, click Allow, done. No API key to copy.

• Claude (web / desktop): Settings → Connectors → Add custom connector → paste the URL.

• Claude Code: claude mcp add --transport http getstoreready https://api.getstoreready.com/mcp

• ChatGPT, Cursor, others: add it as a remote / Streamable HTTP MCP server.

The hosted connector can't see your computer, so the local-only tools (detect_app, capture_screenshots, bootstrap_store_project, upload by file path, saving a store key from a file) are only in the local server below.

B. Local server (simulator capture, local files)

Every client below runs the same command. No API key needed — ask your agent to "sign in to GetStoreReady": the sign_in tool opens getstoreready.com/connect with a short code, you sign up or log in and click Allow, and the key is saved to ~/.config/getstoreready/credentials.json.

{
  "command": "npx",
  "args": ["-y", "github:getstoreready/getstoreready-mcp"]
}

Prefer a fixed key (CI, scripts)? Create one at getstoreready.com/profile/api-keys and set it as GSR_API_KEY in the server's env — it takes precedence over sign_in. The examples below show that optional env block.

Claude Code

Project-scoped (shared via .mcp.json committed to a repo):

claude mcp add getstoreready --scope project -- npx -y github:getstoreready/getstoreready-mcp

Optionally set GSR_API_KEY in your environment (otherwise use sign_in), or add it to the generated .mcp.json:

{
  "mcpServers": {
    "getstoreready": {
      "command": "npx",
      "args": ["-y", "github:getstoreready/getstoreready-mcp"],
      "env": { "GSR_API_KEY": "gsr_live_your_key_here" }
    }
  }
}

User-scoped (available in every project): same block in ~/.claude.json under mcpServers, or claude mcp add --scope user.

Claude Desktop

Settings → Developer → Edit Config (opens claude_desktop_config.json):

{
  "mcpServers": {
    "getstoreready": {
      "command": "npx",
      "args": ["-y", "github:getstoreready/getstoreready-mcp"],
      "env": { "GSR_API_KEY": "gsr_live_your_key_here" }
    }
  }
}

Cursor

Add to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "getstoreready": {
      "command": "npx",
      "args": ["-y", "github:getstoreready/getstoreready-mcp"],
      "env": { "GSR_API_KEY": "gsr_live_your_key_here" }
    }
  }
}

Codex CLI

Add to ~/.codex/config.toml:

[mcp_servers.getstoreready]
command = "npx"
args = ["-y", "github:getstoreready/getstoreready-mcp"]

[mcp_servers.getstoreready.env]
GSR_API_KEY = "gsr_live_your_key_here"

Gemini CLI

Add to ~/.gemini/settings.json:

{
  "mcpServers": {
    "getstoreready": {
      "command": "npx",
      "args": ["-y", "github:getstoreready/getstoreready-mcp"],
      "env": { "GSR_API_KEY": "gsr_live_your_key_here" }
    }
  }
}

Related MCP server: App Store Connect MCP Server

Tools

Account & billing

App bootstrap (from local repo)

Agent skill: getstoreready/getstoreready-skill — install with npx skills add getstoreready/getstoreready-skill.

Quick bootstrap:

1. detect_app({ appRootPath: "/path/to/app" })

2. discover_screenshots({ appRootPath }) — if empty, capture_screenshots({ appRootPath, platform: "ios" })

3. bootstrap_store_project({ appRootPath, templateKey: "random" })

4. update_screen_text per screen (optionally after get_screen_images + vision)

5. Optional: update_listing → translate_project → export_project → store push tools

Projects & templates

Free-form design (full editor parity)

Everything the web editor can do — free text with per-word highlight runs, any Google Font, device mockups with 3D tilt/lean and view presets, image & icon layers, edge fades, gradient/pattern/panorama backgrounds, per-device overrides (iPhone vs iPad vs Android), groups and z-order — is one Design JSON per screen. These tools read and write it directly; the vocabulary comes live from the API, so new editor features show up without an MCP update.

Design loop: get_design_catalog → add_screen / set_screen_design → render_preview → edit_layers tweaks (incl. set_override for tablets) → render_preview again for every enabled slot.

Screen design

Listing & localization

Export

Store push (Premium/Pro)

Link credentials in the web UI first (/projects/:id/settings).

Recommended flows

Template + screenshots (live editor):

1. apply_template({ projectId, templateKey }) — without assetIds

2. upload_screenshots({ images: [{ path: "/local/shot.png" }] })

3. place_screenshot_image once per screen

Screenshot-aware titles (vision on your client):

1. get_screens or get_screen_images — your AI reads the images

2. update_screen_text per screen with generated marketing copy

Bootstrap from an app repo (Flutter / RN / Swift):

1. bootstrap_store_project({ appRootPath: "/path/to/my-app" })

2. update_screen_text for each screen using returned textLayers

3. update_listing when ASO metadata is ready

Add German + translate:

1. estimate_translation({ fromLanguage: "en_US", toLanguage: "de_DE", includeListing: true, includeDesigns: true })

2. get_ai_credits — confirm balance

3. add_store_language({ languageCode: "de_DE" })

4. translate_project({ fromLanguage: "en_US", toLanguage: "de_DE", includeListing: true, includeDesigns: true })

Push to App Store / Google Play:

1. get_app_store_link / get_google_play_link — confirm linked

2. preview_app_store_push / preview_google_play_push — review blockers + diff

3. push_to_app_store / push_to_google_play — enqueue (waits by default)

White backgrounds on all screens:

bulk_update_designs({
  "projectId": "...",
  "background": { "type": "solid", "color": "#ffffff" }
})

Local development

git clone git@github.com:getstoreready/getstoreready-mcp.git
cd getstoreready-mcp
npm install
GSR_API_KEY=... GSR_API_BASE=http://localhost:3201 GSR_SITE_URL=http://localhost:3200 npm run dev

Hosted mode (what runs behind api.getstoreready.com/mcp):

npm run build
PORT=3100 GSR_API_BASE=http://localhost:3201 GSR_PUBLIC_API_BASE=http://localhost:3201 node dist/index.js --http

Configuration

License

MIT

Store connections

Connect a project to App Store Connect / Google Play without the web UI. Secrets are passed as file paths — the MCP reads the file locally and sends it encrypted to GetStoreReady, so keys never enter the chat.