# Icon Generator (icons-gen)

Free, dependency-free icon generator for Chrome extensions, PWAs and favicons.
Humans use the page at https://icons-gen.pages.dev/ (canvas preview, PNG downloads).
Agents can generate icons without a browser:

## Icon API (GET, no auth, CORS enabled)
- https://icons-gen.pages.dev/api/icon.png?text=IG&bg=0f766e&fg=ffffff&radius=12&scale=100&size=128
  Returns a PNG icon (size 8-512, deterministic bundled font). Params: text
  (1-4 chars), bg/fg (6-digit hex, no #), radius (0-50, % of size, 50=circle),
  scale (40-130, text size %), transparent (1/0), preset+maskable=1
  (PWA maskable: full bleed, content in the W3C 40% safe zone).
- https://icons-gen.pages.dev/api/icon.svg?... — same params, SVG output, size up to 1024.
- https://icons-gen.pages.dev/api/pack.zip?preset=chrome|pwa|favicon&text=...&bg=...
  ZIP with one SVG per preset size (chrome: 16/32/48/128, pwa: 192/512,
  favicon: 16/32/48/180 incl. apple-touch-icon), plus manifest.json (or
  links.txt for favicon) and a README.
- https://icons-gen.pages.dev/api/manifest?preset=...  Just the manifest/link snippet.

## Deep links for humans
https://icons-gen.pages.dev/?text=IG&bg=0f766e&fg=ffffff&radius=12&preset=chrome
opens the visual editor pre-configured; PNG downloads live there.

## MCP server
Streamable HTTP endpoint at https://icons-gen.pages.dev/mcp with a generate_icon tool.
Claude Code: claude mcp add --transport http icons-gen https://icons-gen.pages.dev/mcp

## Notes
- PNG output uses a bundled font (deterministic). SVG text uses the
  consumer's sans-serif font stack and may vary slightly between rasterizers.
- OpenAPI spec: https://icons-gen.pages.dev/openapi.json