# FreeVectorIcons

> FreeVectorIcons is an MCP server for design and media. Read and write a FreeVectorIcons collection of icons, briefs and DESIGN.md from an agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, API
- **Website:** https://freevectoricons.com/mcp
- **Repository:** https://github.com/freevectoricons/fvi-mcp
- **MCP Registry name:** io.github.FreeVectorIcons/fvi-mcp
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media)
- **Listing updated:** 2026-11-18

## About

Agents that draw icons inline tend to produce inconsistent SVG, unstable identifiers and unclear licensing from one session to the next. This server addresses that by giving the agent a FreeVectorIcons collection, a versioned store of approved assets with stable IDs and metadata, so it retrieves canonical assets instead of regenerating them. A collection holds catalogue icons, uploaded SVGs, strategy briefs, DESIGN.md and related project files.

Access is bound to one collection through a collection-scoped token (`FVI_TOKEN`), created under the collection's Integrations page. Setting `FVI_READ_ONLY=true` hides the write tools, which park, upload and version assets. Uploads are versioned, so an agent can iterate without losing earlier work. Responses are metadata-first JSON, and file bytes are only fetched when a tool asks for inline content or a download URL.

The package `@freevectoricons/mcp` runs over stdio on Node.js 20 or later, and the README suggests a hosted remote connector at `https://mcp.freevectoricons.com/mcp` for clients that support remote servers. It is marked beta, so tool schemas may change before v1.0.0. It also doubles as a Cursor plugin.

## Features

- **Collection-scoped access:** One token binds the server to a single collection.
- **Stable canonical assets:** Agents fetch approved icons with stable IDs and licence metadata.
- **Versioned uploads:** Uploaded assets keep prior versions so iteration is safe.
- **Design files in context:** Reads briefs, DESIGN.md and brand assets from the collection.
- **Read-only mode:** An environment switch hides the write tools.
- **Hosted option:** A remote connector avoids installing the package.

## Good for

- Let a design agent pull approved icons instead of redrawing them
- Keep a project's DESIGN.md and brief available to agents
- Upload new SVGs back to a collection for review
- Give a read-only token to agents that should not change assets

## Install

### Claude Code (Terminal)

```sh
claude mcp add fvi-mcp --env FVI_TOKEN='<FVI_TOKEN>' -- npx -y @freevectoricons/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "fvi-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@freevectoricons/mcp"
      ],
      "env": {
        "FVI_TOKEN": "<FVI_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "fvi-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@freevectoricons/mcp"
      ],
      "env": {
        "FVI_TOKEN": "<FVI_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "fvi-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@freevectoricons/mcp"
      ],
      "env": {
        "FVI_TOKEN": "<FVI_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "fvi-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@freevectoricons/mcp"
      ],
      "env": {
        "FVI_TOKEN": "<FVI_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "fvi-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@freevectoricons/mcp"
      ],
      "env": {
        "FVI_TOKEN": "<FVI_TOKEN>"
      }
    }
  }
}
```

## FAQ

### Is it stable?

It is labelled beta and tool schemas may change before v1.0.0.

### How is access limited?

A collection-scoped token binds the server to one collection, and `FVI_READ_ONLY=true` hides write tools.

### Do I need an account?

Yes, a FreeVectorIcons account and a collection token.

### Can I use a hosted version?

Yes, `https://mcp.freevectoricons.com/mcp` is offered for remote-capable clients.

### How do I add FreeVectorIcons to Claude Code?

Run this command in your terminal: claude mcp add fvi-mcp --env FVI_TOKEN='<FVI_TOKEN>' -- npx -y @freevectoricons/mcp

### What are the best alternatives to FreeVectorIcons?

The closest alternatives to FreeVectorIcons are HyperFrames by HeyGen, next-ai-draw-io, mcp-for-blender, ffmpeg-skill and cursor-talk-to-figma-mcp.

## Where this comes from

- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [next-ai-draw-io](https://ai-powered.com/mcp/next-ai-draw-io-2): next-ai-draw-io is an open-source MCP server for ai models and llm tooling.
- [mcp-for-blender](https://ai-powered.com/mcp/mcp-for-blender): mcp-for-blender is an open-source MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [cursor-talk-to-figma-mcp](https://ai-powered.com/mcp/cursor-talk-to-figma-mcp): cursor-talk-to-figma-mcp is an open-source MCP server for design and media.
- [Design Feeds](https://ai-powered.com/mcp/design-feeds): Design Feeds is a freemium MCP server for design and media.
- [Meigen AI MCP](https://ai-powered.com/mcp/meigen-ai-mcp): Meigen AI MCP is an open-source MCP server for design and media.
- [Z-Image MCP](https://ai-powered.com/mcp/z-image-mcp): Z-Image MCP is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/freevectoricons
