Run the command
It installs the plugin from the icons8/agent-skills repository
Claude MCP: 420,000+ icons and illustrations
One command adds the server and 10 skills to Claude Code. Icons come from 133 packs. PNG is free, SVG comes with a paid plan.
claude plugin marketplace add icons8/agent-skills &&claude plugin install icons8@icons8New to MCP servers? Start with the guide
How to set up Claude Code MCP
Run the install command from the terminal. Then sign in through the browser.
Open the sign-in menu
Run /mcp in Claude Code. The client shows Needs authentication until you sign in
Sign in through the browser
The endpoint uses OAuth, so sign-in happens in the client
Run the command to install the plugin
claude plugin marketplace add icons8/agent-skills &&claude plugin install icons8@icons8Then run /mcp and sign in through the browser
Claude Code for designers
The agent follows one style instead of picking assets at random. The skills keep it consistent across screens.
One style per project
The Icons8 skill locks your pack choice in a json file. Screen 10 gets the exact same style as screen 1.
Previews, then vector
Test PNG previews in your app for free. When the style is set, fetch SVG with a paid plan and keep the look across screens.
Complete design states
The ux-check skill looks at empty, loading and error states, flows and forms
An icon library for Claude
What the agent gets when you add the server to your project
133 icon packs
With the Icons8 skill, searches run inside the pack you choose, locked in icons8.json
347 illustration styles
The ouch skill locks one illustration style per project in ouch.json
Free PNG previews
PNG previews are free on any account and need no MCP call at all
Server tools
Search, categories, platforms and PNG or SVG delivery. The server keeps no memory between requests.
How skills guide the design workflow
The server returns search results. Skills add the checks that keep a Claude design pass consistent.
asset-check
4 mechanical checks, from emoji standing in for icons to icon names that do not exist
ux-check
Affordance, empty, loading and error states, flows, forms and the accessibility floor
ui-polish
Alignment, radii, shadows, contrast and focus states
design-tokens
Palette, spacing, radii, type scale and dark mode, plus drift between screens
What an agent builds with Icons8 MCP
Scenes of use: the agent picks icons and illustrations from one style
Landing page
A page with illustrations in one style
Dashboard layout
Settings and charts with icons from one pack
Mobile app screen
Navigation and lists with icons at the pack size
Connect to other developer clients
The same server works outside Claude Code, so you are not tied to one client
Other clients
Any client connects to https://mcp.icons8.com/mcp/ over Streamable HTTP. Codex has its own command.
IDE extensions
Cursor and Windsurf add the server through a config file
Shared limits
SVG and other paid formats are capped at 100 an hour, 1,000 a day per account, in any client
Claude alternatives
Other clients that run the same server, and where each keeps its config
| Client | Setup method | Config location |
|---|---|---|
| Cursor | Add to mcp.json | ~/.cursor/mcp.json or .cursor/mcp.json |
| Codex | Run codex mcp add | ~/.codex/config.toml |
| Windsurf | Add to mcp_config.json | ~/.config/devin/mcp_config.json |
Questions about the Icons8 server in Claude Code
No. The endpoint uses OAuth: you sign in through the browser from the client.
PNG is free on any account at any size. SVG needs a paid plan and is capped at 100 an hour, 1,000 a day per account.
The server keeps no memory between requests. The skill locks the pack in icons8.json, so the next request uses the same one.
Not for the plugin or the server. The skill-only route runs through npx, so it needs Node.js.
# One command: the server and 10 skills