Skip to content
MCP server

FreeVectorIcons

Read and write a FreeVectorIcons collection of icons, briefs and DESIGN.md from an agent

Runs locallyStatus and history
Install
Platforms
CLI, API
Runs
Locally
Version
0.3.0-beta.3
Listing updated
today

Similar MCP servers

About FreeVectorIcons

FreeVectorIcons is an MCP server for design and media. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • FVI_TOKENCollection-scoped token (fvi_col_…) from FreeVectorIcons → your collection → Integrations → Setup MCP. The collection is derived from this token. Never commit this value.Required
  • FVI_API_URLAPI origin including /api. Leave the default for production.
  • FVI_READ_ONLYSet true to hide write tools (park, upload, version).

What it does

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

FreeVectorIcons 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.

How AIPoweredBot checks servers