Quickstart

Generate store assets from your own tools.

One POST with a 1024 square returns a zip — the icon endpoint is open, no key required, the same one the web generator itself calls. The MCP server and CLI call the exact same endpoint, also with no account or key required.

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

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, no API key. It wraps the same Go API the web app uses, exposing generate_icon as a tool, fully open the same way the web generator is.

.cursor/mcp.json

{
  "mcpServers": {
    "glyphus": {
      "url": "https://api.glyphus.dev/mcp"
    }
  }
}

Tool reference

One tool, 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.