Quickstart

Generate store assets from your own tools.

One POST with a 1024 square returns a zip — the icon and screenshot endpoints are open, no key required, the same ones the web generator itself calls. The MCP server and CLI add a key-gated layer on top for agent/programmatic access.

curl

> curl -X POST https://api.glyphus.dev/v1/icons/generate \
>   -F file=@icon.png -F platforms=iphone,ipad,android \
>   -o app-icons.zip
● 200 · application/zip

Get an API key MCP server setup

MCP server

Add it to your editor.

A hosted MCP server at api.glyphus.dev/mcp — no local process to run, no npm package to install. It wraps the same Go API the web app uses, exposing generate_icon, generate_screenshots, and generate_feature_graphic as tools. Get a key on the account page first.

.cursor/mcp.json

{
  "mcpServers": {
    "glyphus": {
      "url": "https://api.glyphus.dev/mcp",
      "headers": { "Authorization": "Bearer sk_live_…" }
    }
  }
}

Tool reference

Three tools, one contract.

generate_iconStableOne square in, the full icon set out.

ParameterTypeNotes

sourcefilePNG or JPG, square. 1024 recommended; down to 128 is accepted and upscaled.

platformsenum[]iphone · ipad · macos · watchos · android · liquid-glass, comma-separated. Default: iphone,ipad,android.

catalogboolWrite Contents.json alongside the iOS sizes. Default true.

zipboolReturn one archive rather than a file list. Default true.

response

● 200 · application/zip
● x-glyphus-files: 21
● x-glyphus-bytes: 183296
● x-glyphus-run: run_0142

Errors

Every failure names the fix.

400source_not_squareRe-export at 1024 × 1024. The generator never crops for you.

400source_too_smallBelow 128px there isn't enough detail to upscale usefully. Send 1024 for best results, or 128 or larger to let the generator upscale.

415unsupported_mediaSend PNG or JPG bytes. SVG and PDF are not resampled.

429rate_limitedBack off for the seconds named in retry-after and try again.

503render_timeoutRetry once. If it repeats, drop the batch size and report the run id.

Rate limits

What generation endpoints allow.

1 / secsustained · per IP

5burst capacity · per IP

3reference images / request

10 MiBmax reference image size

Pricing

Free for your own files. $12/mo for AI.

Free

$0Forever

Unlimited deterministic generation, no account needed.

Unlimited icon, screenshot, and feature graphic generation from your own files5 free AI-assisted generations (icon, screenshot, or feature graphic — combined)Web app, MCP server, and CLINo account required for the web generator

Open the generator

ProUnlimited AI

$12Per month

Unlimited AI generation, everywhere you work.

Everything in FreeUnlimited AI-assisted icon, screenshot, and feature graphic generationSame limit on the web app, MCP server, and CLI — no per-surface capsCancel anytime from your account page

Upgrade to Pro

Every plan produces the exact same files — App Store/Play Store sizes, Xcode-ready Contents.json, device-framed screenshots. Pro only unlocks unlimited AI-assisted generation; the deterministic pipeline stays free forever, everywhere.

API keys

One key per client.

The free web generator needs no account — keys are only for programmatic access (the MCP server and CLI). Sign in with GitHub or Google to create and manage keys.

Manage your API keysSign in, create a key, revoke anytime.Go to account

Keys are shown once on creation. Revoking a key takes effect immediately.