gitwtfhub

wtf is storeshots-mcp?

mtbun/storeshots-mcp — explained in plain English

Analysis updated 2026-05-18

4TypeScriptAudience · developerComplexity · 2/5LicenseSetup · easy

TL;DR

An MCP server that turns raw app screenshots into polished, exact-dimension App Store and Google Play listing images.

Mindmap

mindmap
  root((storeshots-mcp))
    What it does
      Generates store screenshots
      Device frames and headlines
      Exact store dimensions
    Tech stack
      TypeScript
      MCP server
      Node CLI
    Use cases
      App Store listings
      Google Play listings
      Multi-language sets
    Audience
      App developers
      Indie app makers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Generate App Store and Google Play screenshots with device frames and headlines from raw app captures.

REASON 2

Produce translated screenshot sets for multiple languages using an AI agent to write the copy.

REASON 3

Create a Google Play feature graphic at the exact required dimensions.

REASON 4

Use the command line tool directly without an AI agent for scripted screenshot generation.

What's in the stack?

TypeScriptNode.jsMCP

How it stacks up

mtbun/storeshots-mcp0labs-in/vision-linkadarsh-me/image-sdk
Stars444
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasymoderateeasy
Complexity2/53/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

No API keys or accounts needed, runs fully offline via npx.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

storeshots-mcp is a tool that turns plain app screenshots into polished, ready to publish images for the App Store and Google Play. It works as an MCP server, which means it plugs into AI coding assistants like Claude Code, Claude Desktop, Cursor, and several others, letting the AI agent handle the creative writing while storeshots handles the actual image rendering. The split of labor described in the README is that the AI agent looks at your app's code, figures out its selling points, writes short punchy headlines, and can translate that copy into other languages. The storeshots server then takes that text and lays it over device frames, such as an iPhone or Android phone outline, at the exact pixel dimensions each app store requires. Everything renders locally on the user's own machine, with no API keys, no accounts, and no image generation costs, and the same input always produces the same output. The tool ships five ready made presets covering common store formats: iPhone screenshots, Android phone screenshots, iPad, Android tablet, and a wide Google Play feature graphic. It also draws device frames programmatically, automatically flips text color between light and dark depending on the background, and bundles a font that correctly displays accented and special characters for multiple languages. Setup is a single command to add it as an MCP server in a supported tool, or it can be installed and used directly as a command line tool without any AI agent at all. Once connected, a user can simply describe what they want, such as generating a full six screenshot set in English and Turkish with a specific brand color, and the agent and server work together to produce the files. There is also an optional Claude Code skill that walks through the entire process step by step. The project is released under the MIT license.

Yoink these prompts

Prompt 1
Help me add storeshots-mcp to Claude Code and generate my first App Store screenshot set.
Prompt 2
Take the screenshots in my raw-shots folder and generate a full App Store and Play Store set with my brand color.
Prompt 3
Show me how to generate the same screenshot set in Turkish and German.
Prompt 4
Explain how to use the storeshots CLI without an MCP client.

Frequently asked questions

wtf is storeshots-mcp?

An MCP server that turns raw app screenshots into polished, exact-dimension App Store and Google Play listing images.

What language is storeshots-mcp written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, MCP.

What license does storeshots-mcp use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is storeshots-mcp to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is storeshots-mcp for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.