{
  "markdown": "# imagcon-mcp\n\nLocal MCP server that wraps the [Imagcon](https://imagcon.app) 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.\n\n## Requirements\n\n- Python 3.11–3.12\n- [uv](https://docs.astral.sh/uv/) (provides `uvx`)\n- An Imagcon API key starting with `ic_live_` from [imagcon.app/api-keys](https://imagcon.app/api-keys)\n\n## Install\n\nThe package is self-hosted (not on PyPI). Install directly from the wheel:\n\n```bash\nclaude mcp add imagcon -- uvx --from https://imagcon.app/downloads/imagcon_mcp-0.3.0-py3-none-any.whl imagcon-mcp --api-key ic_live_...\n```\n\nOr with the key in the environment instead of on the command line:\n\n```bash\nclaude mcp add imagcon -- uvx --from https://imagcon.app/downloads/imagcon_mcp-0.3.0-py3-none-any.whl imagcon-mcp\n```\n\n```bash\nexport IMAGCON_API_KEY=ic_live_...\n```\n\nFor other MCP clients (Cursor, Windsurf, VS Code, Cline, Zed, Warp, Continue.dev), use the equivalent stdio config:\n\n```json\n{\n  \"mcpServers\": {\n    \"imagcon\": {\n      \"command\": \"uvx\",\n      \"args\": [\"--from\", \"https://imagcon.app/downloads/imagcon_mcp-0.3.0-py3-none-any.whl\", \"imagcon-mcp\", \"--api-key\", \"ic_live_...\"]\n    }\n  }\n}\n```\n\nPer-client config file locations and full examples: see CLIENT-CONFIGS in [imagcon.app/.well-known/blueprint.txt](https://imagcon.app/.well-known/blueprint.txt).\n\n## Tools\n\n**Images**\n\n- **`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.\n- **`save_image`** — Save a generated image to your gallery by `image_key` and `name`.\n- **`list_saved_images`** — List all saved source images with keys and preview URLs.\n- **`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 `./`).\n- **`install_pwa_pack`** — Same builder as `create_icons_from_key`. Splash is a second credit and defaults to false.\n\n**Icon sets**\n\n- **`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.\n- **`create_pwa_icons_from_image`** — Same PWA pipeline from an existing local PNG/JPEG/WebP at `image_path` (no AI generation).\n- **`list_saved_icon_sets`** — List saved icon sets with IDs.\n- **`download_icon_set`** — Download a saved icon set ZIP by `set_id`, extract to `output_dir`.\n- **`get_icon_set_download_url`** — Get an authenticated download URL for a saved icon set ZIP by `set_id`.\n\n**Splash screens**\n\n- **`generate_splash_screens`** — AI-generate a source image and produce 16 iOS splash screens, extract to `output_dir` (default `./public/splash`).\n- **`create_splash_screens_from_image`** — Same splash pipeline from an existing local PNG/JPEG/WebP at `image_path` (no AI generation).\n- **`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.\n- **`download_splash_screens`** — Download a saved splash screen set ZIP by `set_id`, extract to `output_dir`.\n- **`get_splash_screen_download_url`** — Get an authenticated download URL for a saved splash screen set ZIP by `set_id`.\n\n**Account**\n\n- **`get_credit_balance`** — Returns remaining Imagcon credits.\n- **`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}`.\n\nAI 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.\n\n## Configuration\n\n| Source | Variable / flag |\n|--------|------------------|\n| Environment | `IMAGCON_API_KEY` |\n| CLI | `--api-key` (overrides the env var) |\n\nIf the key is missing, the process exits with an error pointing to [imagcon.app/api-keys](https://imagcon.app/api-keys).\n\n## API base URL\n\nAll requests go to `https://imagcon.app` (no other base URL is supported).\n",
  "bytes": 4607,
  "sha": "abfd825c82bbe91f9e59119f71b07f1841e1a0158b90ad187c67831600b08e3b",
  "repo_slug": "explorer-64/imagcon-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_explorer_64_imagcon_mcp_f492ff0e/readme"
}