Skip to main content
Glama

# 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

Related MCP server: Nano Banana

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

  • generate_image — AI-generate a source image from a text description. Returns image_key and a preview URL. Show the preview to the user and confirm before generating icons.

  • save_image — Save a generated image to your gallery by image_key and name.

  • list_saved_images — List all saved source images with keys and preview URLs.

  • create_icons_from_key — Generate a PWA install pack from an already-saved image_key. Returns html_head + a signed ZIP URL; local stdio also extracts to output_dir (default ./).

  • install_pwa_pack — Same builder as create_icons_from_key. Splash is a second credit and defaults to false.

Icon sets

  • generate_pwa_icons — AI-generate a source image, then a droppable public/ tree. Extract to output_dir (default ./). Do not pass ./public/icons — that nests.

  • create_pwa_icons_from_image — Same PWA pipeline from an existing local PNG/JPEG/WebP at image_path (no AI generation).

  • list_saved_icon_sets — List saved icon sets with IDs.

  • download_icon_set — Download a saved icon set ZIP by set_id, extract to output_dir.

  • get_icon_set_download_url — Get an authenticated download URL for a saved icon set ZIP by set_id.

Splash screens

  • generate_splash_screens — AI-generate a source image and produce 16 iOS splash screens, extract to output_dir (default ./public/splash).

  • create_splash_screens_from_image — Same splash pipeline from an existing local PNG/JPEG/WebP at image_path (no AI generation).

  • create_splash_screens_from_key — Same splash pipeline from an existing image_key (e.g. from generate_image or list_saved_images) — composites the icon on each canvas size without re-generating.

  • download_splash_screens — Download a saved splash screen set ZIP by set_id, extract to output_dir.

  • get_splash_screen_download_url — Get an authenticated download URL for a saved splash screen set ZIP by set_id.

Account

  • get_credit_balance — Returns remaining Imagcon credits.

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

AI image generation (generate_image, generate_pwa_icons, generate_splash_screens) and icon/splash set exports use credits. create_pwa_icons_from_image, create_splash_screens_from_image, create_splash_screens_from_key, and create_icons_from_key skip AI generation credits but still charge for export.

Configuration

Source

Variable / flag

Environment

IMAGCON_API_KEY

CLI

--api-key (overrides the env var)

If the key is missing, the process exits with an error pointing to imagcon.app/api-keys.

API base URL

All requests go to https://imagcon.app (no other base URL is supported).

Available Tools

6 tools
download_icon_setBInspect

Re-download a previously saved PWA icon set ZIP by its set ID.

Inputs: set_id (required), output_dir. Returns: result

download_splash_screensCInspect

Re-download a previously saved splash screen set ZIP by its set ID.

Inputs: set_id (required), output_dir. Returns: result

generate_pwa_iconsDInspect

Inputs: description (required), output_dir. Returns: result

generate_splash_screensBInspect

Generate iOS and Android splash screens from a text description and download as a ZIP. background_color must be a hex color string (e.g. '#ffffff').

Inputs: description (required), background_color, output_dir. Returns: result

get_credit_balanceDInspect

Inputs: no named parameters. Returns: result

list_saved_icon_setsAInspect

List all PWA icon sets previously saved in the user's gallery.

Inputs: no named parameters. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.6/5.0

    Scored across 6 tools

    Disambiguation4/5

    Tool names clearly differentiate between icon and splash screen operations, but two tools have empty descriptions, which could cause confusion for an agent.

    Naming Consistency4/5

    Most tools follow a verb_noun pattern in snake_case, but get_credit_balance uses 'get' instead of 'list' or 'download', causing slight inconsistency.

    Tool Count5/5

    Six tools is well-scoped for a PWA icon and splash screen generation service, covering core operations without being overwhelming.

    Completeness4/5

    The set covers generate, download, list, and credit checking, but is missing update/delete for saved sets, though that aligns with a generation-focused service.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Automatically generates complete favicon sets from PNG images or URLs, creating multiple sizes, ICO files, Apple touch icons, and manifest.json for web applications.
      2
      34
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Generate, edit, and restore images using natural language prompts through the Gemini 2.5 Flash image model. Supports creating app icons, seamless patterns, visual stories, and technical diagrams with smart file management.
      8
      10
      Apache 2.0