For developers & coding agents

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.

REST API, Bearer keys MCP server included 4 options in about a minute Expo, iOS, Android & web files Absolute URLs on all media

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.

Auth
curl -H "Authorization: Bearer ss_YOUR_KEY" \ "https://icons.flavrapps.com/api.php?action=me"

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:

.mcp.json
{ "mcpServers": { "iconic-icons": { "command": "npx", "args": ["-y", "iconic-icons-mcp"], "env": { "ICONIC_API_KEY": "ss_YOUR_KEY" } } } }

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

  1. Create a projectproject_create with the app's name and what it does: free.
  2. Generate 4 optionsicon_generate_set plans five ideas, renders them and keeps the best four, each with its concept and why. 1 credit per icon, about a minute.
  3. Tweak oneicon_iterate keeps the design and changes one thing you describe. 1 credit.
  4. Choose and exportproject_choose, then project_export_sizes with platforms (expo, ios, android, web) for a zip and a file list. Free.
End to end
# 1. project curl -X POST -H "Authorization: Bearer $KEY" \ -d '{"name":"Crumb","app_description":"a sourdough companion"}' \ "https://icons.flavrapps.com/api.php?action=project_create" # 2. four options (4 credits) curl -X POST -H "Authorization: Bearer $KEY" \ -d '{"project_id":1}' \ "https://icons.flavrapps.com/api.php?action=icon_generate_set" # 3. tweak one (1 credit) curl -X POST -H "Authorization: Bearer $KEY" \ -d '{"image_id":42,"change":"make the band orange"}' \ "https://icons.flavrapps.com/api.php?action=icon_iterate" # 4. choose & export (free) curl -X POST -H "Authorization: Bearer $KEY" \ -d '{"id":1,"image_id":43}' \ "https://icons.flavrapps.com/api.php?action=project_choose" curl -X POST -H "Authorization: Bearer $KEY" \ -d '{"id":1,"platforms":["expo"]}' \ "https://icons.flavrapps.com/api.php?action=project_export_sizes"

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.

ActionWhat it doesCost
project_create / project_getCreate a branding project; fetch it with all images + assetsFree
project_suggestAI-suggested icon symbols for the app (stored, re-pickable free)1 credit
icon_generate_setFour options from the brief, each with its concept, why and twist; optional style, palette, brand colours and HD1 credit per icon
icon_iterateTweak an existing icon (“make the band orange”) without losing the design1 credit
icon_generateOne icon per call, symbol or lettermark1 credit
starter_pack_buildPlan a varied ~20-icon starter pack from picked symbols + stylesFree to plan
brand_pack_create / brand_pack_asset_generateLock a brand pack to an icon; generate light/dark/mono variants + marketing art1 credit per asset
project_export_sizes / project_brandkitIcon files for Expo, iOS, Android (adaptive, themed, round) and web (maskable) with a manifest; the full brand-kit zipFree

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.