For AI Agents

App Store screenshots, generated by your AI agent

Give Claude Code, Codex, Cursor, Windsurf, or Gemini CLI the Makeshots skill and ask for store screenshots in plain English. Your agent uploads your raw app screens, Makeshots does the art direction and ASO copywriting server-side — the exact pipeline behind the web generator — and hands back store-ready panels.

How it works

1Create an API key

In the dashboard, open API access and create a key (mks_live_…). Keys need a credit-based plan — BYOK subscriptions generate in the web app only.

2Install the skill

One command per agent, below. The skill teaches your agent the whole flow: collect screens, preflight credits, generate, save the finished images.

3Ask for screenshots

Same output and credits as the web generator — 1 credit per set of up to 3 screenshots — and every generation also shows up in your dashboard.

Install for your agent

Pick your agent, run the install command, set MAKESHOT_API_KEY, and you're done.

Install the Makeshots skill into Claude Code's skills directory. Claude picks it up automatically and invokes it whenever you ask for store screenshots.

1 · Install the skill

mkdir -p ~/.claude/skills/makeshot
curl -fsSL https://www.makeshots.app/agents/skill.md -o ~/.claude/skills/makeshot/SKILL.md

2 · Add your API key to ~/.claude/settings.json

{
  "env": {
    "MAKESHOT_API_KEY": "mks_live_your_key_here"
  }
}

3 · Restart Claude Code, then ask

Use makeshot to create App Store screenshots — my app screens are in ./screens, the app is "TaskFlow", a focus timer for students. 6 screenshots, Minimal style, iPhone 6.9".

Keep your key out of chat. The skill reads MAKESHOT_API_KEY from the environment at run time and never prints it. Don't paste keys into prompts or commit them to git — you can revoke a key any time from the dashboard.

API reference

Prefer to wire it up yourself? Two endpoints, authenticated with Authorization: Bearer mks_live_….

Check the account

GET /api/v1/me

Returns api_access (false on BYOK plans), the active plan, and the credit balance — agents use it to preflight a run before spending anything.

Generate a screenshot set

POST /api/v1/screenshots

multipart/form-data. Runs the full generator pipeline and returns signed URLs to store-ready panels. Sets of 3 render sequentially with later sets visually anchored on the first, so expect ~2–3 minutes per set.

Field	Values	Notes
appName	text	Required
appDescription	text, 1–2 sentences	Required
screenshots	1–10 image files (PNG/JPG/WebP)	Required — your raw app screens; repeat the field per file
sizeId	iphone-69 · iphone-65 · iphone-55 · ipad · android-phone · android-tablet	Default iphone-69
count	3–9	Sets of 3 · 1 credit per set
styleId	signature · minimal · bold-type · studio	Default signature
language	en + 20 store languages (fr, de, ja, zh-hans, …)	Copy is written natively in the language
includeSubtitles	1 · 0	0 = headlines only
templateId	ref1–ref6	Style source — provide exactly one of these three
styleReference	1 image file
styleMode	app

Response

{
  "generation_id": "…",
  "size": "iphone-69",
  "count": 6,
  "style": "minimal",
  "language": "en",
  "sets": 2,
  "credits_spent": 2,
  "screenshots": [
    { "index": 1, "width": 1260, "height": 2736, "url": "https://…signed…" }
  ],
  "credits_remaining": 9
}

Error responses are { "error": "…", "code": "…" }:

AUTH_REQUIRED (401) — missing, invalid, or revoked API key.
BYOK_NOT_SUPPORTED (403) — the account is on a BYOK subscription; the API needs a credit-based plan.
SCREENSHOT_CREDITS_EXHAUSTED (402) — not enough credits for the requested run; nothing is charged.

Billing is failure-safe: each set's credit is charged right before that set renders and refunded automatically if it fails. If a later set fails, the finished screenshots are still returned with a warning.

FAQ

Which AI agents work with Makeshots?

Any agent that can run shell commands: Claude Code (as a skill), Codex CLI (AGENTS.md), Cursor (project rule), Windsurf (rule), Gemini CLI (GEMINI.md), and any custom agent that can read the instructions file and call the API with curl.

How much does a generation cost through the API?

Exactly the same as the web generator: 1 credit per set of up to 3 screenshots. 3 screenshots cost 1 credit, 6 cost 2, 9 cost 3. Credits come from the same balance as your dashboard.

Does the API work on the BYOK plan?

No. The agent API is available on credit-based plans only. BYOK subscriptions generate in the web app with your own OpenAI key; switch to a credit plan to use the API.

Is the output the same as the web generator?

Yes — the API runs the identical pipeline: style extraction, ASO copywriting, and one render per set of 3, with later sets anchored on the first so the whole listing shares one design system. Generations also appear in your web dashboard.