# BLUEPRINT: Imagcon [MCP]
# Version: 3.14.1
# URL: https://imagcon.app
# Updated: 2026-08-26

## CAPABILITIES
generate-icon-set: https://imagcon.app/blueprints/generate-icon-set.txt | mcp | Generate a full PWA icon set from a text description
create-pwa-icons-from-image: https://imagcon.app/blueprints/create-pwa-icons-from-image.txt | mcp | Generate a PWA icon set from a local image file
generate-image: https://imagcon.app/blueprints/generate-image.txt | mcp | Generate a source image and return image_key plus preview URL
save-image: https://imagcon.app/blueprints/save-image.txt | mcp | Save a generated image to the gallery by name
list-saved-images: https://imagcon.app/blueprints/list-saved-images.txt | mcp | List saved source images with keys and preview URLs
create-icons-from-key: https://imagcon.app/blueprints/create-icons-from-key.txt | mcp | Generate a PWA install pack from an existing image_key
install-pwa-pack: https://imagcon.app/blueprints/install-pwa-pack.txt | mcp | Drop a public/ PWA tree and html_head from an image_key
generate-splash-screens: https://imagcon.app/blueprints/generate-splash-screens.txt | mcp | Generate iOS splash screens from a text description
create-splash-screens-from-key: https://imagcon.app/blueprints/create-splash-screens-from-key.txt | mcp | Generate iOS splash screens from an existing image_key
create-splash-screens-from-image: https://imagcon.app/blueprints/create-splash-screens-from-image.txt | mcp | Generate iOS splash screens from a local image file
list-saved-icon-sets: https://imagcon.app/blueprints/list-saved-icon-sets.txt | mcp | List previously saved PWA icon sets
download-icon-set: https://imagcon.app/blueprints/download-icon-set.txt | mcp | Re-download a saved icon set as an install pack
get-icon-set-download-url: https://imagcon.app/blueprints/get-icon-set-download-url.txt | mcp | Get a signed ZIP URL for a saved icon set
download-splash-screens: https://imagcon.app/blueprints/download-splash-screens.txt | mcp | Re-download a saved splash screen set
get-splash-screen-download-url: https://imagcon.app/blueprints/get-splash-screen-download-url.txt | mcp | Get a signed ZIP URL for a saved splash set
check-credits: https://imagcon.app/blueprints/check-credits.txt | mcp | Read the account's remaining generation credits
setup-wallet-profile: https://imagcon.app/blueprints/setup-wallet-profile.txt | mcp | Activate a permanent account after an x402 payment
edit-image: https://imagcon.app/blueprints/edit-image.txt | human-only | Crop, draw on, and refine an image in the browser editor
resize-image: https://imagcon.app/blueprints/resize-image.txt | ui | Resize a gallery image to social or OG presets
browse-inspiration: https://imagcon.app/blueprints/browse-inspiration.txt | ui | Browse the public gallery of generated images
purchase-credits: https://imagcon.app/blueprints/purchase-credits.txt | human-only | Buy additional credits via checkout
manage-api-keys: https://imagcon.app/blueprints/manage-api-keys.txt | human-only | Create and revoke Imagcon API keys
pay-per-call-icons-from-image: https://imagcon.app/blueprints/pay-per-call-icons-from-image.txt | x402 | Pay per call to generate a PWA icon set from an image
pay-per-call-splash-from-image: https://imagcon.app/blueprints/pay-per-call-splash-from-image.txt | x402 | Pay per call to generate iOS splash screens from an image
pay-per-call-generate-image: https://imagcon.app/blueprints/pay-per-call-generate-image.txt | x402 | Pay per call to generate a source image
pay-per-call-generate-pwa-icons: https://imagcon.app/blueprints/pay-per-call-generate-pwa-icons.txt | x402 | Pay per call to generate a PWA icon set from a prompt
pay-per-call-generate-splash-screens: https://imagcon.app/blueprints/pay-per-call-generate-splash-screens.txt | x402 | Pay per call to generate splash screens from a prompt
pay-per-call-resize-image: https://imagcon.app/blueprints/pay-per-call-resize-image.txt | x402 | Pay per call to resize an image
pay-per-call-validate-x402: https://imagcon.app/blueprints/pay-per-call-validate-x402.txt | x402 | Probe an x402 endpoint and report facilitator verdict
pay-per-call-check-icon-x402: https://imagcon.app/blueprints/pay-per-call-check-icon-x402.txt | x402 | Pay per call to check icon maskable and platform compliance
link-wallet-to-account: https://imagcon.app/blueprints/link-wallet-to-account.txt | api | Link a wallet profile to an Imagcon account

## IDENTITY
name: Imagcon
description: Generates a complete, deployment-ready set of PWA app icons from a single text description — all required sizes, safe-zone masking, iOS Xcode icons, Android icons, splash screens, and manifest.json, packaged as a ZIP. Also supports uploading your own image and editing it with crop, draw, text overlay, and AI refinement before export.
category: design
contact: support@imagcon.app

## SUMMARY
tagline: Generate a complete PWA icon set from a single text description — every size, every platform, packaged as a ZIP.
audience: Indie developers and vibe coders who need professional app icons for PWA, iOS, and Android without a designer.
capabilities:
  - generate-icon-set: Full PWA icon package (30 files + manifest.json + Xcode + Android) from a text prompt (MCP tool: generate_pwa_icons)
  - create-pwa-icons-from-image: Full PWA icon package from an existing PNG/JPEG/WebP on your machine (local imagcon-mcp stdio only — not on hosted mcp.imagcon.app)
  - generate-image: AI-generate a source image from a text description; returns image_key and preview URL for user approval before committing to icon generation
  - save-image: Save a generated image to the gallery with a name for later reuse
  - list-saved-images: List all saved source images with keys and preview URLs
  - create-icons-from-key: Full PWA icon set from an already-saved image_key — skips generation, reuses approved image directly
  - install-pwa-pack: Droppable public/ PWA tree + html_head from an image_key (MCP tool: install_pwa_pack). Splash is a second credit and defaults to false.
  - generate-splash-screens: 19 iOS splash screens packaged as a ZIP
  - create-splash-screens-from-key: 19 iOS splash screens from an existing image_key — composites the icon on each canvas size without re-generating; use this when the icon is already saved
  - create-splash-screens-from-image: 19 iOS splash screens from an existing PNG/JPEG/WebP on your machine (local imagcon-mcp stdio only — not on hosted mcp.imagcon.app)
  - list-saved-icon-sets: List previously generated icon sets in the user's gallery
  - download-icon-set: Re-download a saved icon set ZIP by ID without regenerating
  - get-icon-set-download-url: Direct download URL string for a saved icon set ZIP (MCP tool: get_icon_set_download_url; local imagcon-mcp stdio only — not on hosted mcp.imagcon.app)
  - download-splash-screens: Re-download a saved splash screen set ZIP by ID without regenerating
  - get-splash-screen-download-url: Direct download URL string for a saved splash screen set ZIP (MCP tool: get_splash_screen_download_url; local imagcon-mcp stdio only — not on hosted mcp.imagcon.app)
  - check-credits: Report the user's remaining generation credit balance (MCP tool: get_credit_balance)
  - setup-wallet-profile: Activate a permanent Imagcon account after an anonymous x402 payment (MCP tool: setup_wallet_profile; local imagcon-mcp stdio only — not on hosted mcp.imagcon.app)
  - edit-image: Human-only — manual crop / draw / text overlay / AI refine on an existing image before export. Agents should call generate-icon-set with a refined prompt instead.
  - resize-image: Resize any gallery or uploaded image to social/OG presets (1200×630 Open Graph, Twitter card, YouTube thumbnail, Instagram) or custom dimensions with smart fit modes (cover, contain, blur-fill, stretch). Free for images generated on Imagcon; uploads use pooled credits (10 resizes per credit).
  - pay-per-call-validate-x402: x402 endpoint validator ($0.01) — signs a real payment from a fresh unfunded wallet against any x402 endpoint and reports the facilitator's verdict (healthy/broken/payment-ignored) plus challenge lint and 402index discovery. For sellers testing deploys and agents doing pre-flight due diligence.
  - pay-per-call-check-icon-x402: PWA/icon compliance checker ($0.01) — tells you if an icon you already have is maskable-safe, Android adaptive safe-zone compliant, or iOS-ready. Structured pass/warn/fail/undetermined report; distinct from icons-from-image which generates a full set.

## AUTH
provider: firebase
methods: email-password, oauth-google

## X402 WALLET PROFILES
default: A successful anonymous x402 payment creates a 60-day temporary paper profile unless the request sends X-Imagcon-Profile: none.
refresh: Each successful paid call for a temporary profile resets expires_at to 60 days from that payment.
first-payment-headers: X-Imagcon-Token, X-Imagcon-Api-Key, X-Imagcon-Profile-Setup, X-Imagcon-Profile-Status, X-Imagcon-Profile-Expires.
repeat-temp-headers: X-Imagcon-Token, X-Imagcon-Profile-Setup, X-Imagcon-Profile-Status, X-Imagcon-Profile-Expires. The API key is not retained or re-sent.
continuity: Send X-Imagcon-Token on paid retries when the payer wallet rotates.
activate: POST https://imagcon.app/routes/x402/profile/activate with terms confirmation and a wallet signature over imagcon.app/profile/activate:{profile_token}:{unix_timestamp}. Set rotate_api_key=true to replace a lost key once.
decline: POST https://imagcon.app/routes/x402/profile/decline with a wallet signature over imagcon.app/profile/decline:{profile_token}:{unix_timestamp}. Wallet profile data and saved assets are deleted; payment records are retained.
expiry: Expired temporary profiles and their API keys are revoked server-side. A later payment starts a fresh 60-day profile.

## MCP
server: imagcon-mcp
preferred-transport: streamable_http
install: claude mcp add imagcon -- uvx --from https://imagcon.app/downloads/imagcon_mcp-0.3.0-py3-none-any.whl imagcon-mcp --api-key <<api-key>>
requirements: uv/uvx installed (https://docs.astral.sh/uv/). Python 3.11–3.12 required — 3.13 free-threaded ABI has wheel issues with some MCP dependencies. Run once; uvx fetches the wheel from imagcon.app automatically.
auth: IMAGCON_API_KEY — user's Imagcon API key from Account Settings > API Keys (https://imagcon.app/api-keys). Keys start with ic_live_ and are issued long-lived. Pass as --api-key argument to uvx.

### TRANSPORT (streamable_http)
url: https://mcp.imagcon.app
auth: bearer ${IMAGCON_API_KEY}
note: Hosted HTTP. Put this in ~/.cursor/mcp.json (user scope), NOT project .cursor/mcp.json which gets committed with the key. Some clients append /mcp — https://mcp.imagcon.app/mcp is an alias for /.

### TRANSPORT (stdio)
command: uvx
args: ["--from", "https://imagcon.app/downloads/imagcon_mcp-0.3.0-py3-none-any.whl", "imagcon-mcp", "--api-key", "${IMAGCON_API_KEY}"]
note: Runs as a local stdio process on the user's machine — this transport keeps no persistent
connection and gains output_dir extraction (default ./ so the public/ ZIP tree lands correctly).
Requires uv + Python 3.11–3.12. Hosted MCP returns a signed pack_url instead of extracting.
Local-stdio-only tools: create_pwa_icons_from_image, create_splash_screens_from_image,
get_icon_set_download_url, get_splash_screen_download_url, setup_wallet_profile.
requirements: uv/uvx must be installed and on PATH (https://docs.astral.sh/uv/).
Python 3.11 or 3.12 required.

### REQUIRED-SECRETS
- IMAGCON_API_KEY:
    description: Your Imagcon API key for MCP and API access
    obtain-at: https://imagcon.app/api-keys
    format: ic_live_*
    warning: never commit the raw key to git

### CLIENT-CONFIGS
claude-code-cli: https://imagcon.app/blueprints/mcp-clients/claude-code-cli.txt
claude-code-vscode: https://imagcon.app/blueprints/mcp-clients/claude-code-vscode.txt
cursor: https://imagcon.app/blueprints/mcp-clients/cursor.txt
windsurf: https://imagcon.app/blueprints/mcp-clients/windsurf.txt
vscode-copilot: https://imagcon.app/blueprints/mcp-clients/vscode-copilot.txt
cline-roo: https://imagcon.app/blueprints/mcp-clients/cline-roo.txt
zed: https://imagcon.app/blueprints/mcp-clients/zed.txt
warp: https://imagcon.app/blueprints/mcp-clients/warp.txt
continue: https://imagcon.app/blueprints/mcp-clients/continue.txt
cloud-platforms: https://imagcon.app/blueprints/mcp-clients/cloud-platforms.txt

## ACCESS
preferred: mcp
last-resort: ui

## TIMING
# Format: <operation-label>: <observed-range> — use max: <N>s
ai-image-generation: 15–45s — use max: 60s
ai-image-refinement: 20–90s — use max: 120s
icon-set-generation: 5–15s — use max: 30s
splash-screen-generation: 20–60s — use max: 90s
image-resize: 1–3s — use max: 10s
x402-endpoint-validation: 3–10s — use max: 30s
icon-compliance-check: 1–3s — use max: 10s
file-upload: 2–5s — use max: 15s