Locate the configuration file
Find the JSON file for your IDE. Cursor and Windsurf use different paths.
Windsurf MCP and Cursor: Icons8 setup guide
Add the server to your configuration file to get 420,000+ icons and 110,000+ illustrations in your editor. Icon PNG is free on any account, while SVG comes with a paid plan.
{"mcpServers": {"icons8mcp": {"url": "https://mcp.icons8.com/mcp/"}}}Then sign in from the MCP settings
New to MCP servers? Start with the guide
How to configure your Cursor MCP integration
Install the server by adding one custom JSON object to your local setting file. You can configure it globally or per project.
Paste the code example
Add the server URL to the file and save it
Authenticate the client
Open your IDE and sign in from the MCP settings
Pick your IDE and update the location
# Global: ~/.cursor/mcp.json{"mcpServers": {"icons8mcp": {"url": "https://mcp.icons8.com/mcp/"}}}Then sign in from the MCP settings
Using Icons8 alongside your current tools
What to know before the agent starts fetching
PNG is free, SVG is paid
Icon PNG is free on any account. SVG needs a paid plan.
Pick a pack first
A bare search returns one metaphor in 10 styles. Choose one pack before you ask for icons.
Write the choice down
The server keeps no memory between requests. The Icons8 skill saves one pack per project in icons8.json.
Ranking follows names and tags
A search for settings can put Apple logos above the plain gear, so check what comes back
What your agent puts on the page
Ask in plain words, and the agent searches the Icons8 catalogue
Interface icons
Get navigation, menu, and settings icons from 133 packs. Each pack lists a recommended size and a color flag.
Empty state illustrations
Choose from 347 illustration styles. Scenes fit empty states and onboarding.
3D illustrations
The original 3D illustration comes as PNG only, because it has no vector
Configuration file locations
Where to save the JSON config for each client
| Client | Applies to | Location path |
|---|---|---|
| Cursor | All projects | ~/.cursor/mcp.json |
| Cursor | One project | .cursor/mcp.json |
| Windsurf | Default | ~/.config/devin/mcp_config.json |
| Windsurf | Windows | %APPDATA%\devin\mcp_config.json |
Questions about the integration
No. You sign in through the browser from the MCP settings in your client.
PNG previews are free on any account. Paid formats like SVG are capped at 100 an hour and 1,000 a day per account.
Yes. Both use the same endpoint and their own install commands, not a JSON edit.
Windsurf docs are rebranded Devin Desktop, so the config path says devin
# ~/.cursor/mcp.json