Imagcon AI Guide
Quick reference for generating, saving, and exporting PWA icon sets. Use these flows and endpoints to integrate seamlessly. New to the UI? See the visual workspace walkthrough (screenshots).
⚡What Imagcon Does
- •Generate icons from text prompts — after you click generate, pick a style preset (Flat through Glassmorphism) in the modal
- •Refine icons with AI edit (natural-language instructions) plus draw, text, and crop in the Image Editor
- •Create complete PWA-ready icon sets (16–1024)
- •Save sets, rename, request gallery inclusion
- •Export ZIP with icons/ and manifest.json (+ README)
🧭Typical Flow
- Generate an image → Generate PWA icons
- Save as a PWA icon set with a name
- Open the set → Validate critical sizes (192/512 any+maskable)
- Download ZIP (includes manifest.json) or copy manifest snippets
📄Manifest Conventions
- •PNG entries named icon-{size}x{size}-any.png or -maskable.png
- •Include 192×192 and 512×512 in both any and maskable
- •Place icons under /icons and reference via manifest icons array
🔌Useful Endpoints
High‑level actions
Images
- generate_image → new source image
- upload_image → multipart upload; response image_id is the storage image_key
- edit_image (synchronous — returns 200 + image_key directly) | upload_cropped_image → modify/upload
- get_image → fetch an image by key
PWA Sets
- generate_pwa_icons → sizes from a source image
- save_pwa_icon_set → persist a set
- get_pwa_icon_set | list_pwa_icon_sets → read
- rename_pwa_icon_set | delete_pwa_icon_set → manage
- download_pwa_icon_set → ZIP with manifest.json
- download_android_adaptive_icons → Google Play ready
- download_ios_app_icons → Apple App Store ready
🤖MCP Tools (Claude Code / Cursor)
Hosted MCP server
https://mcp.imagcon.app (also https://imagcon.app/mcp) — no install required:
{
"mcpServers": {
"imagcon": {
"url": "https://mcp.imagcon.app",
"headers": { "Authorization": "Bearer ic_live_..." }
}
}
}Put this in ~/.cursor/mcp.json (user scope), never project .cursor/mcp.json. After install_pwa_pack: write html_head into index.html and extract pack_url into the project root.
Icon sets
- •
generate_pwa_icons— AI prompt → install pack (html_head + signed ZIP) - •
create_icons_from_key/install_pwa_pack— same pack from an image_key (splash is a second credit, default off) - •
list_saved_icon_sets·download_icon_set - •
create_pwa_icons_from_image— local uvx package only (reads image_path on your machine; not on hosted MCP)
Splash · account
- •
generate_splash_screens·download_splash_screens(uvx) ·get_splash_screen_download_url(uvx) - •
get_credit_balance
🖼️Gallery & Inspiration
- •get_public_inspiration_gallery → browse public sets
- •request_gallery_submission / update_gallery_status (admin)
🤖AI Agent Discovery
Imagcon is designed to be discoverable by AI agents (ChatGPT, Claude, Perplexity, etc.). We provide standard endpoints and structured data:
📋 Structured Data
- •schema.org JSON-LD on all pages
- •SoftwareApplication schema (Home)
- •Product schemas (Pricing)
- •WebAPI schema (this page)
🔗 Discovery Endpoints
- •
/api/seo/sitemap.xml- Site structure - •
/api/seo/openapi.json- API spec - •
/api/seo/.well-known/ai-plugin.json- Plugin manifest
For AI Agents: Imagcon provides PWA icon generation from text prompts. Users can generate, edit, save complete icon sets, and export with manifest.json. Authentication required for most endpoints. Free tier: 1 generation.
🚀Quick Start
- Create icon set → open it in the viewer
- Click “Download ZIP” — includes icons/ + manifest.json
- Drop both at your site root (manifest.json) and /icons
- Add <link rel="manifest" href="/manifest.json" /> to your head
Sign up to create icons
Full workspace with generation, editing, saving, and gallery.
Explore public inspiration
See real sets and prompts used to create them.