Log inSubmit server
Icogenie MCP logo

Icogenie MCP

by albertnahas

Generate, refine, batch, download, and manage SVG icon assets through IcoGenie using MCP tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Icogenie MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "albertnahas-icogenie-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@icogenie/mcp"
      ],
      "env": {
        "ICOGENIE_API_URL": "YOUR_VALUE_HERE",
        "ICOGENIE_SESSION_TOKEN": "YOUR_VALUE_HERE",
        "ICOGENIE_CONFIG_DIR": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

albertnahas/icogenie-mcp MCP server connects AI agents to IcoGenie for text-to-icon generation, refinement, bundle creation, and asset downloads. It uses an interactive browser login by default, or a session token for automated environments, and stores authentication locally. Use it when an MCP-compatible client needs to create SVG and PNG icon assets, review watermarked previews, or retrieve saved library items. Preview and download operations consume credits according to IcoGenie's pricing.

Use cases

  • Generate SVG icons from short text prompts
  • Refine selected icon variations
  • Create consistent icon bundles
  • Export SVG and PNG packages
  • Reuse saved icons from the library

Key features

  • Text-to-SVG icon previews
  • Solid and outline styles
  • Two-phase icon regeneration
  • Bundle planning and generation
  • SVG and PNG package downloads
  • Saved icon library management

Tools11

What Icogenie MCP lets your agent do. Expand a tool for its parameters.

Verified live~2.0k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

17/17 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · @icogenie/mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars8Stargazers on the source repository.
npm downloads417Package downloads in the last 30 days.
Last commit7mo agoMost recent push to the default branch.
Tools exposed11Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Icogenie MCP works

What albertnahas/icogenie-mcp MCP server does

albertnahas/icogenie-mcp MCP server exposes IcoGenie's icon-generation workflow through Model Context Protocol. An AI agent can request an icon from a short text prompt, choose a solid or outline style, request multiple variations, and refine a selected variation. The service returns previews for evaluation and provides a separate download step for final assets.

It also supports multi-icon bundles. An agent can ask IcoGenie to turn a bundle description into a proposed icon list, review or supply the list, and then generate the set. Generated items can be saved to a personal library, browsed with pagination or tag filters, and downloaded again without an additional export charge.

How it works

Install the npm package globally or launch it with npx. The server communicates with IcoGenie and exposes the operations as MCP tools to clients such as Claude Desktop, Claude Code, and Cursor. On first use, it opens a browser authentication flow, requests approval, and saves the resulting session token under the IcoGenie configuration directory. Later runs reuse that token, which is also shared with the IcoGenie CLI.

The normal single-icon flow is to check credits, call generate_icon, optionally call regenerate_icon, and select a result with confirm_regeneration. Preview generation costs one credit, while the final download_icon export costs five credits for a single icon or four credits per icon in a bundle. Previews are watermarked and low resolution; downloading is required for the final unwatermarked SVG and PNG package.

Bundle planning is separate from bundle generation. normalize_bundle creates a proposed list and returns a bundle identifier. That identifier can be passed to generate_bundle for traceability, with generation charged at one credit per icon.

Setup and configuration

Install with:

Terminal
npm install -g @icogenie/mcp

Or run it directly:

Terminal
npx @icogenie/mcp

For Claude Desktop, add an MCP entry that runs npx -y @icogenie/mcp. Claude Code can use the server when it is installed globally or invoked through npx.

Interactive authentication is the default. For CI/CD or other headless environments, set ICOGENIE_SESSION_TOKEN to bypass the browser flow. ICOGENIE_API_URL changes the API endpoint, and ICOGENIE_CONFIG_DIR changes where configuration is stored; the documented defaults are IcoGenie's hosted endpoint and ~/.icogenie.

Tools and capabilities

The albertnahas/icogenie-mcp MCP server provides tools for:

  • Generating and regenerating single-icon previews.
  • Confirming one candidate from a four-option regeneration result.
  • Checking balances and claiming two free daily credits once every 24 hours.
  • Planning and generating icon bundles.
  • Exporting SVG and PNG packages to a specified path, or returning base64 when no path is supplied.
  • Saving generated items, listing library entries, filtering by tag, and downloading saved items for free.

Keep prompts concise. The service normalizes prompts internally, and the documentation warns that verbose descriptions can produce cluttered icons. Use a descriptive working-directory filename when saving output files.

Limitations and notes

Credit usage matters: previews, regeneration, and downloads have separate charges, while confirmation and library operations are free. Bundle normalization is free but rate-limited. Preview responses are not production assets because they are watermarked and low resolution. The final export is delivered through download_icon; saved library items can be downloaded again without an additional export charge.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Icogenie MCP

albertnahas/icogenie-mcp is an MCP server that connects AI agents to IcoGenie for generating SVG icon previews and bundles. Its main tools create and regenerate icons, confirm variations, download final SVG and PNG packages, check credits, and manage saved library items. It authenticates through a browser or a supplied session token.

Install it globally with `npm install -g @icogenie/mcp`, or run it directly with `npx @icogenie/mcp`. For Claude Desktop, configure the MCP server command as `npx` with `-y` and `@icogenie/mcp` as its arguments. Claude Code can use a global installation or npx.

It authenticates through a browser on first use and saves the session token in the IcoGenie configuration directory. For CI/CD or headless environments, set `ICOGENIE_SESSION_TOKEN` to skip browser authentication. The saved session is also shared with the IcoGenie CLI.

Yes, the README identifies Cursor as a use case for the MCP server. Configure Cursor to launch the standard npm or npx server process, then authenticate with IcoGenie when prompted. The available tools can generate previews, create bundles, and download final assets.

Related MCP servers

All in Art & Culture All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewIcogenie MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/albertnahas-icogenie-mcp?style=directory)](https://allmcps.com/mcp/albertnahas-icogenie-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/albertnahas-icogenie-mcp"><img src="https://allmcps.com/api/badge/albertnahas-icogenie-mcp?style=directory" alt="Icogenie MCP on AllMCPs" /></a>