imagcon-mcp
This server provides tools for generating, managing, and downloading PWA icon sets and iOS splash screens using the Imagcon API — all from within an AI assistant.
Generate PWA Icons (
generate_pwa_icons): AI-generate a source image from a text description, resize it to all PWA sizes, and extract the full icon set (includingmanifest.jsonand maskable assets) to a local output directory (default:./public/icons).Generate Splash Screens (
generate_splash_screens): AI-generate a source image and produce iOS splash screens with a configurable background color (default:#ffffff), extracted to a local output directory (default:./public/splash).List Saved Icon Sets (
list_saved_icon_sets): Retrieve a list of all previously saved PWA icon sets in your gallery.Download Icon Set (
download_icon_set): Re-download a previously saved PWA icon set ZIP by its set ID and extract it to a specified directory (default:./public/icons).Download Splash Screens (
download_splash_screens): Re-download a previously saved splash screen set ZIP by its set ID and extract it to a specified directory (default:./public/splash).Check Credit Balance (
get_credit_balance): View the remaining Imagcon API credits on your account.
Allows generation of PWA icon sets including various sizes, maskable assets, and manifest.json using the Imagcon API.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
# 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
ic_live_from imagcon.app/api-keys
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-mcpexport 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. Returnsimage_keyand a preview URL. Show the preview to the user and confirm before generating icons.save_image— Save a generated image to your gallery byimage_keyandname.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-savedimage_key. Returnshtml_head+ a signed ZIP URL; local stdio also extracts tooutput_dir(default./).install_pwa_pack— Same builder ascreate_icons_from_key. Splash is a second credit and defaults to false.
Icon sets
generate_pwa_icons— AI-generate a source image, then a droppablepublic/tree. Extract tooutput_dir(default./). Do not pass./public/icons— that nests.create_pwa_icons_from_image— Same PWA pipeline from an existing local PNG/JPEG/WebP atimage_path(no AI generation).list_saved_icon_sets— List saved icon sets with IDs.download_icon_set— Download a saved icon set ZIP byset_id, extract tooutput_dir.get_icon_set_download_url— Get an authenticated download URL for a saved icon set ZIP byset_id.
Splash screens
generate_splash_screens— AI-generate a source image and produce 16 iOS splash screens, extract tooutput_dir(default./public/splash).create_splash_screens_from_image— Same splash pipeline from an existing local PNG/JPEG/WebP atimage_path(no AI generation).create_splash_screens_from_key— Same splash pipeline from an existingimage_key(e.g. fromgenerate_imageorlist_saved_images) — composites the icon on each canvas size without re-generating.download_splash_screens— Download a saved splash screen set ZIP byset_id, extract tooutput_dir.get_splash_screen_download_url— Get an authenticated download URL for a saved splash screen set ZIP byset_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 fromX-Imagcon-Token, name,terms_confirmed(after reading https://imagcon.app/terms-of-service), and a wallet signature overimagcon.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 |
|
CLI |
|
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 toolsdownload_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
Scored across 6 tools
Tool names clearly differentiate between icon and splash screen operations, but two tools have empty descriptions, which could cause confusion for an agent.
Most tools follow a verb_noun pattern in snake_case, but get_credit_balance uses 'get' instead of 'list' or 'download', causing slight inconsistency.
Six tools is well-scoped for a PWA icon and splash screen generation service, covering core operations without being overwhelming.
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
Related MCP Connectors
Generate matching icon sets, spot illustrations and transparent design assets for sites and apps.
Check, generate, and troubleshoot complete favicon, Apple touch icon, PWA, and web app icon sets.
Generate logos, social posts, app screenshots, comic panels & visual-novel assets from prompts.
Lock a style and palette, then generate matching icons, favicons, social images and illustrations.
Related MCP Servers
- AlicenseAqualityDmaintenanceAutomatically generates complete favicon sets from PNG images or URLs, creating multiple sizes, ICO files, Apple touch icons, and manifest.json for web applications.234MIT
- AlicenseBqualityDmaintenanceGenerate, 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.810Apache 2.0
- AlicenseNot gradedqualityCmaintenanceGenerates all required web app icons and manifest files from a single source image with framework auto-detection. Supports Next.js App Router, traditional web apps, and PWA standards with zero configuration.15 npmMIT
- AlicenseAqualityDmaintenanceRoutes one brief to the right image model across 60+ (gpt-image-1.5, Ideogram 3, Recraft V4, Flux), validates the output, and fans out to iOS/Android/PWA/favicon/visionOS/Flutter bundles. Works without an API key via Pollinations, HF Inference, Stable Horde, or host-LLM inline SVG.2425MIT