@stora-sh/mcp

Stora's Model Context Protocol server. Exposes screenshots, ASO, compliance, and submission tooling to any MCP-compatible client: Claude Code, Cursor, Antigravity, Zed, Windsurf, ChatGPT Desktop.

Stora is the post-code layer. Your IDE writes code; stora handles screenshots, compliance, metadata, and submission.

Install

npm install -g @stora-sh/mcp
# or
npx @stora-sh/mcp

Auth

Grab an API key at https://stora.sh/settings/api-keys. Keys look like sk_stora_….

export STORA_API_KEY=sk_stora_…

For local dev against a self-hosted stora instance:

export STORA_BASE_URL=http://localhost:3000/api/v1

Wiring

Claude Code

Add to ~/.claude/mcp_servers.json (or the equivalent per-project file):

{
  "mcpServers": {
    "stora": {
      "command": "npx",
      "args": ["@stora-sh/mcp"],
      "env": { "STORA_API_KEY": "sk_stora_…" }
    }
  }
}

Cursor

Settings → MCP → Add:

{
  "stora": {
    "command": "npx",
    "args": ["@stora-sh/mcp"],
    "env": { "STORA_API_KEY": "sk_stora_…" }
  }
}

Antigravity / Zed / Windsurf

Same pattern — npx @stora-sh/mcp with STORA_API_KEY in env.

Tools

| Tool | What it does | |---|---| | stora_list_projects | List every Stora project the key can access. | | stora_get_project | Fetch a single project by ID (via listProjects + filter). | | stora_get_metadata | Read active App Store + Play metadata + ASO profile. | | stora_update_metadata | Create a new active metadata version. | | stora_list_screenshots | List screenshot collections for a project. | | stora_generate_screenshots | Start a cloud capture run. | | stora_get_screenshots | Get raw + generated screenshots for a collection. | | stora_check_compliance | Trigger a compliance scan. | | stora_get_compliance_results | Full scan results with issues + scores. | | stora_record_local_submission | Bookkeeping only — does NOT submit to Apple/Google. See below. | | stora_get_status | Latest submission + active version state. |

Submission note

stora_record_local_submission wraps POST /api/v1/projects/:id/submit, which only writes a local submissions row. It does not transmit to App Store Connect or Google Play. For real App Store submission, use the Stora dashboard or call /api/apple/submit-for-review directly. Google Play write-path via v1 is not yet implemented.

Example prompts

• "Claude, list my Stora projects."
• "Run a compliance scan on proj_abc123. When it finishes, summarize the critical issues."
• "Generate screenshots for proj_abc123 on iPhone 17 Pro and iPad Pro 13, then wait for the collection to complete."
• "Update the iOS subtitle to 'Ship faster' for proj_abc123."

Development

npm install
npm run build
npm test

License

MIT