Skip to main content
npm package · @getillustrations/mcp-server

The GetIllustrations npm Package

@getillustrations/mcp-server is the official, open-source (MIT) Model Context Protocol server. Install it locally and your AI assistant can search and download from 170,000+ vector icons & illustrations — right inside the conversation.

npx @getillustrations/mcp-server
v2.2.0 MIT licensed Node.js 18+ Zero config to search
View on npm → See the full MCP product
About the package

What You're Installing

This npm package runs the MCP server locally over stdio — perfect for desktop and IDE clients like Claude Desktop, Claude Code, Cursor, Windsurf, Cline and Continue. npx downloads and runs it on demand, so there's nothing to install globally and updates are automatic.

Prefer no install at all? Claude web and ChatGPT can connect to the same library through the hosted remote connector at https://getillustrations.com/mcp — see the full MCP product page for that and every supported client. Both paths expose the same tools; this package is simply the local one.

Two ways to run it

Install

Most clients call it through npx — you don't install anything yourself. To run it directly, install it globally.

Run on demand Recommended

No install — npx fetches the latest version each run

npx @getillustrations/mcp-server

Install globally

Adds the getillustrations-mcp command to your PATH

npm install -g @getillustrations/mcp-server

getillustrations-mcp
Add to your client

Configure

Add this to your AI client's MCP config. Search works without a key; add an API key to download the actual SVG/PNG.

Claude Desktop Recommended

Add to claude_desktop_config.json

{
  "mcpServers": {
    "getillustrations": {
      "command": "npx",
      "args": ["-y", "@getillustrations/mcp-server"],
      "env": {
        "GETILLUSTRATIONS_API_KEY": "gi_free_your_key_here"
      }
    }
  }
}

Claude Code

Add to .mcp.json in your project root

{
  "mcpServers": {
    "getillustrations": {
      "command": "npx",
      "args": ["-y", "@getillustrations/mcp-server"],
      "env": {
        "GETILLUSTRATIONS_API_KEY": "gi_free_your_key_here"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project

{
  "mcpServers": {
    "getillustrations": {
      "command": "npx",
      "args": ["-y", "@getillustrations/mcp-server"],
      "env": {
        "GETILLUSTRATIONS_API_KEY": "gi_free_your_key_here"
      }
    }
  }
}

Create your key (a free GetIllustrations account works) at Account → API Keys and paste it as GETILLUSTRATIONS_API_KEY. Free keys cover free icons plus your own library; paid keys the full 170,000+ library. Unlicensed assets return a watermarked demo preview.

Inside the package

18 Built-in Tools

Search & discover, download by plan (clean or watermarked demo), and a bundled knowledge base. See the full tool reference →

Search & Discover (4)

  • search_icons — Search 129,000+ vector icons by keyword
  • search — Unified search across illustrations, icons & packs
  • show_gallery — Show several results as an inline thumbnail gallery
  • recommend_assets — Suggest assets & packs for your project

Download & Retrieve (4)

  • get_icon — Icon SVG + inline preview — clean if your key covers it
  • get_illustration — Illustration SVG/PNG + inline preview — clean if licensed
  • fetch — Full record for one asset by id (title, tags, preview, page)
  • get_account — Your plan, download limits & remaining quota

Knowledge (10)

  • get_pricing · get_licensing · get_faq
  • get_company_info · get_features
  • get_popular_packs · get_use_cases
  • get_style_guide · get_available_tools
  • get_contact_info
The facts

Package Details

Name@getillustrations/mcp-server
Version2.2.0
LicenseMIT
RequiresNode.js 18 or higher
Binarygetillustrations-mcp
Dependencies@modelcontextprotocol/sdk, zod
Registrynpmjs.com/package/@getillustrations/mcp-server
SupportHelp Center · MCP FAQ

Install in Under 2 Minutes

Grab a free API key, drop the config into your AI client, and start pulling illustrations by conversation.

View on npm → Get your API key

Open source (MIT) • 18 built-in tools • Works with any MCP client

Forget Password!