Branding your agent can ship on its own.
Point Claude Code, Cursor or any script at the Iconic Icons API: four icon options from a one-line brief, a tweak by text, then every file iOS, Android, Expo and the web need, without opening a browser.
1 · Get an API key
Sign in, then create a key under Account → API access. Keys look like ss_… and are shown once. Send them as a Bearer header on every call — generations spend the same credits as the studio.
2 · Hook it into your agent (MCP)
The MCP server, iconic-icons-mcp on npm, exposes the whole flow as tools: iconic_generate_set (4 options with thumbnails your agent can see), iconic_tweak_icon, iconic_choose_icon and iconic_export by platform. Every tool description states its credit cost. Add it to your agent config:
Then a prompt like “give my Expo app an icon” lets the agent create a project, show you four options, apply your tweak, export the Expo files and wire up app.json.
3 · Or drive the REST API directly
- Create a project
project_createwith the app's name and what it does: free. - Generate 4 options
icon_generate_setplans five ideas, renders them and keeps the best four, each with its concept and why. 1 credit per icon, about a minute. - Tweak one
icon_iteratekeeps the design and changes one thing you describe. 1 credit. - Choose and export
project_choose, thenproject_export_sizeswithplatforms(expo, ios, android, web) for a zip and a file list. Free.
Key endpoints
Every response is JSON with an ok flag; all media carries an absolute_url your agent can fetch. A missing or revoked key returns 401, bad input 422 (before any charge), and out of credits 402 with need_credits: true.
| Action | What it does | Cost |
|---|---|---|
project_create / project_get | Create a branding project; fetch it with all images + assets | Free |
project_suggest | AI-suggested icon symbols for the app (stored, re-pickable free) | 1 credit |
icon_generate_set | Four options from the brief, each with its concept, why and twist; optional style, palette, brand colours and HD | 1 credit per icon |
icon_iterate | Tweak an existing icon (“make the band orange”) without losing the design | 1 credit |
icon_generate | One icon per call, symbol or lettermark | 1 credit |
starter_pack_build | Plan a varied ~20-icon starter pack from picked symbols + styles | Free to plan |
brand_pack_create / brand_pack_asset_generate | Lock a brand pack to an icon; generate light/dark/mono variants + marketing art | 1 credit per asset |
project_export_sizes / project_brandkit | Icon files for Expo, iOS, Android (adaptive, themed, round) and web (maskable) with a manifest; the full brand-kit zip | Free |
Ready to wire it in?
Create a key, drop the MCP server into your agent, and your next project can arrive with its branding already done.