Skip to main content
Model Context Protocol · @getillustrations/mcp-server

MCP Server for AI Assistants

Connect Claude, Cursor, and other AI tools to 169K+ illustrations. Search, browse, and discover assets through natural conversation.

npx @getillustrations/mcp-server
Free to install 25 built-in tools Works with any MCP client
The protocol

How It Works

MCP (Model Context Protocol) is an open standard that lets AI assistants access external tools and data sources. The GetIllustrations MCP server connects your AI assistant directly to our full library of illustrations and icons.

Once configured, you can search for illustrations, browse packs by style or category, check licensing details, and discover assets — all through natural conversation with your AI tool. No manual browsing required.

Two-minute install

Quick Setup

Add the following JSON to your AI client's configuration file.

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"
      }
    }
  }
}

Claude Web & ChatGPT No install

Add a remote connector — Claude: Settings → Connectors → Add custom connector. ChatGPT: Settings → Connectors.

Name:              GetIllustrations
Remote MCP URL:    https://getillustrations.com/mcp

The hosted connector searches the full library and delivers free assets clean; premium assets return a watermarked demo. For your plan's clean downloads, use the npx configs above with your API key.

Create your key (a free GetIllustrations account works) at Account → API Keys and paste it as GETILLUSTRATIONS_API_KEY. Search works without a key; a key is only needed to download the actual SVGs — free keys cover free icons plus your own library, paid keys the full 170,000+ library.

The API surface

16 Built-in Tools

Search the full library, then download the real asset — the clean SVG/PNG when your plan covers it, a watermarked demo when it doesn't.

Search & Discover (3 tools)

  • search_icons — Search 129,000+ vector icons by keyword
  • search — Unified search across illustrations, icons & packs
  • recommend_assets — Suggest assets & packs for your project

Download (3 tools)

  • get_icon — Icon SVG — clean if your key covers it, else a watermarked demo
  • get_illustration — Illustration SVG or PNG — clean if licensed, else a watermarked demo
  • get_account — Your plan, download limits & remaining quota

Knowledge (10 tools)

  • get_pricing — Current pricing plans and options
  • get_licensing — License terms and usage rights
  • get_faq — Frequently asked questions
  • get_company_info — About GetIllustrations
  • get_available_tools — Tools & integrations (editor, plugins, MCP)
  • get_popular_packs — Most popular illustration packs
  • get_use_cases — Common use cases and inspiration
  • get_style_guide — Illustration styles and when to use each
  • get_contact_info — Contact and support information
  • get_features — Platform features overview
Beyond Claude & Cursor

Works With Any MCP-Compatible Tool

The MCP standard is supported by a growing number of AI tools. If your tool supports MCP, it can connect to GetIllustrations. Here are some popular options beyond Claude and Cursor:

Windsurf (Codeium)

Add the same JSON config to your Windsurf MCP settings. Windsurf supports MCP natively for AI-assisted coding with illustration assets.

Cline / Continue.dev

Both Cline and Continue support MCP servers. Add the config to your VS Code extension settings to search illustrations while coding.

Custom Agents (Python / Node.js)

Build your own AI agent that uses GetIllustrations. Use the Anthropic SDK or OpenAI SDK with MCP tool calling to connect any LLM to our library.

Ask in plain language

What You Can Do

Find the Right Illustration

"Find me flat-style illustrations about teamwork and collaboration for a SaaS landing page."

Discover by Style

"Show me all hand-drawn illustration packs. I need something warm and organic for a wellness app."

Check Licensing and Pricing

"Can I use these illustrations in a client project? What license do I need?"

Get Pack Recommendations

"I'm building a fintech dashboard. Which packs would work best? My budget is under $50."

Before you install

Requirements

Node.js 18 or higher

Required to run the MCP server. Download Node.js

A GetIllustrations account

Free or paid. Create one in seconds

API key from Account Settings

Generate your key in Account Settings

Ready to Get Started?

Create a free account, grab your API key, and connect your AI assistant in under 2 minutes.

Get Started Free → Review the setup

Free to install • 25 built-in tools • Works with any MCP client

Forget Password!