Setup
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"icogenie": {
"command": "npx",
"args": ["-y", "@icogenie/mcp"]
}
}
}Claude Code (VS Code / CLI)
Add to your .mcp.json in project root or ~/.claude/mcp.json
{
"mcpServers": {
"icogenie": {
"command": "npx",
"args": ["-y", "@icogenie/mcp"]
}
}
}Requires: Node.js 18+ • Restart Claude after configuration
Authentication
First-time use
When Claude uses an IcoGenie tool for the first time, your browser will open to authenticate. Approve the session, and it's saved automatically.
Shared with CLI
The session token is stored at ~/.icogenie/config.json and shared with the CLI. Login once, use everywhere.
CI/CD Environments
Set the environment variable to skip browser authentication:
export ICOGENIE_SESSION_TOKEN="your-session-token"Tools
generate_icon1 creditGenerate a single icon preview from a text description.
Parameters
prompt*·string·Description of the iconstyle·"solid" | "outline"·Icon style (default: solid)variations·1 | 2 | 4·Number of variations (default: 1)referenceImagePath·string·Path to reference image for styleReturns: sessionId, preview, creditsRemaining
regenerate_icon1 creditRegenerate a specific icon variation with a custom refinement prompt.
Parameters
sessionId·string·For single iconsbundleId·string·For bundle iconsindex*·number·Which variation (0-based)prompt·string·Optional refinement promptReturns: preview, creditsRemaining
download_icon5 credits (single) or 4/icon (bundle)Download the final SVG + PNG package for an icon or bundle.
Parameters
generationId·string·For single iconsbundleId·string·For bundlesoutputPath·string·Path to save ZIP fileReturns: savedTo or base64 data
normalize_bundleFreePlan an icon bundle by generating an AI-enhanced icon list from a description.
Parameters
description*·string·Description of the bundletargetCount·number·Target number of icons (2-20)style·"solid" | "outline"·Preferred styleReturns: icons array, styleRecommendation, reasoning
generate_bundle1 credit per iconGenerate a bundle of icons from an icon list.
Parameters
icons*·array·Array of {name, description}style·"solid" | "outline"·Icon style (default: solid)referenceImagePath·string·Path to reference imageReturns: bundleId, icons with previews, creditsUsed
check_creditsFreeCheck your current credit balance and account info.
Returns: credits, team, user
Workflows
Single Icon
Generate preview
generate_icon({ prompt: "notification bell", style: "outline" })Refine if needed
regenerate_icon({ sessionId: "abc123", index: 0, prompt: "Add dot indicator" })Download package
download_icon({ generationId: "abc123", outputPath: "./icons/bell.zip" })Icon Bundle
Plan bundle (free)
normalize_bundle({ description: "e-commerce app icons", targetCount: 8 })Generate icons
generate_bundle({ icons: [...], style: "outline" })Download all
download_icon({ bundleId: "xyz789", outputPath: "./icons.zip" })Tip: Ask Claude to generate icons naturally: "Create a set of icons for my food delivery app"
Credits
| Action | Cost |
|---|---|
| Preview (single) | 1 credit |
| Preview (bundle) | 1 credit/icon |
| Download (single) | 5 credits |
| Download (bundle) | 4 credits/icon |
| Regenerate | 1 credit |
| Plan bundle / Check credits | Free |
New accounts receive 8 free credits. Purchase more credits when you run out.
Ready to generate icons with AI?