Imagcon MCP server

imagcon-mcp

Local MCP server that wraps the Imagcon API so assistants can generate PWA icon sets (all sizes, maskable assets, manifest.json) and iOS splash screens without opening the site. Runs as a stdio process via uvx — no hosted service dependency, no persistent connections.

Requirements

• Python 3.11–3.12
• uv (provides uvx)
• An Imagcon API key starting with iclive from imagcon.app/api-keys

Install

The package is self-hosted (not on PyPI). Install directly from the wheel:

claude mcp add imagcon -- uvx --from https://imagcon.app/downloads/imagcon_mcp-0.3.0-py3-none-any.whl imagcon-mcp --api-key ic_live_...

Or with the key in the environment instead of on the command line:

claude mcp add imagcon -- uvx --from https://imagcon.app/downloads/imagcon_mcp-0.3.0-py3-none-any.whl imagcon-mcp

export IMAGCON_API_KEY=ic_live_...

For other MCP clients (Cursor, Windsurf, VS Code, Cline, Zed, Warp, Continue.dev), use the equivalent stdio config:

{
  "mcpServers": {
    "imagcon": {
      "command": "uvx",
      "args": ["--from", "https://imagcon.app/downloads/imagcon_mcp-0.3.0-py3-none-any.whl", "imagcon-mcp", "--api-key", "ic_live_..."]
    }
  }
}

Per-client config file locations and full examples: see CLIENT-CONFIGS in imagcon.app/.well-known/blueprint.txt.

Tools

Images

• generateimage — AI-generate a source image from a text description. Returns imagekey and a preview URL. Show the preview to the user and confirm before generating icons.
• saveimage — Save a generated image to your gallery by imagekey and name.
• listsavedimages — List all saved source images with keys and preview URLs.
• createiconsfromkey — Generate a PWA install pack from an already-saved imagekey. Returns htmlhead + a signed ZIP URL; local stdio also extracts to outputdir (default ./).
• installpwapack — Same builder as createiconsfrom_key. Splash is a second credit and defaults to false.

Icon sets

• generatepwaicons — AI-generate a source image, then a droppable public/ tree. Extract to output_dir (default ./). Do not pass ./public/icons — that nests.
• createpwaiconsfromimage — Same PWA pipeline from an existing local PNG/JPEG/WebP at image_path (no AI generation).
• listsavediconsets** — List saved icon sets with IDs.
• downloadiconset — Download a saved icon set ZIP by setid, extract to outputdir.
• geticonsetdownloadurl — Get an authenticated download URL for a saved icon set ZIP by set_id.

Splash screens

• generatesplashscreens — AI-generate a source image and produce 16 iOS splash screens, extract to output_dir (default ./public/splash).
• createsplashscreensfromimage — Same splash pipeline from an existing local PNG/JPEG/WebP at image_path (no AI generation).
• createsplashscreensfromkey — Same splash pipeline from an existing imagekey (e.g. from generateimage or listsavedimages) — composites the icon on each canvas size without re-generating.
• downloadsplashscreens — Download a saved splash screen set ZIP by setid, extract to outputdir.
• getsplashscreendownloadurl — Get an authenticated download URL for a saved splash screen set ZIP by set_id.

Account

• getcreditbalance — Returns remaining Imagcon credits.
• setupwalletprofile — Activate a permanent Imagcon account after a pay-per-call x402 payment. Pass wallet address, profile token from X-Imagcon-Token, name, termsconfirmed (after reading https://imagcon.app/terms-of-service), and a wallet signature over imagcon.app/profile/activate:{profiletoken}:{unix_timestamp}.

Shortened. The full README is on GitHub.