Overflow Design

손으로 그린 아이콘, 일러스트레이션 및 등각 투영 드로잉을 의미로 검색하여 SVG, JSX 또는 파일로 가져옵니다.

호스팅형 MCP 서버

npx add-mcp 'https://www.overflow.design/api/mcp/'

Claude Code, Codex, Cursor 등에 설치됩니다

문서

Overflow in your coding agent

Overflow Design has an MCP server. Connect it to Claude Code, Cursor, VS Code, Codex or any other MCP client, and your agent can search all 1,953 drawings by what they show and write them straight into your project. The free set works without a key; Pro opens the rest.

Designing in Figma instead? The same drawings are in the plugin. Get the Figma plugin

Quick start

Paste this into your coding agent and it sets itself up, then asks before it changes anything else. With Pro, put your licence key in the environment variable OVERFLOW_LICENCE first. The config reads it from there, so the key stays out of your repository.

Connect this project to Overflow Design's MCP server.

1. Add the server to your MCP config as "overflow": https://www.overflow.design/api/mcp/ over Streamable HTTP, with the address exactly as written.
2. If the environment variable OVERFLOW_LICENCE is set, send it as the header "Authorization: Bearer <licence key>", with the config reading the variable rather than holding the key. Check it without printing it, and never write the key into this repository. If it is not set, leave the header out: the free drawings need no key.
3. Append the rules from https://www.overflow.design/mcp/agents.md, word for word, to AGENTS.md, or to CLAUDE.md if that is the file you read. Create the file if it is missing.
4. Stop and ask me before changing anything else.

Then tell me what you changed, and whether you need a restart to load the server. Each agent's config is at https://www.overflow.design/mcp/.

Then try a first request. It asks for a free drawing, so it works without a key.

Put the free Overflow isometric server drawing in my home page's hero, as inline SVG.

To set it up by hand instead, the address and each agent's config follow.

The address

https://www.overflow.design/api/mcp/

Streamable HTTP. Use it exactly as written, with the www. and the final slash: the bare domain answers with a redirect that turns the request into one the server cannot read.

Without a key

Add the address and nothing else. Your agent can search everything and fetch the free drawings: 194 icons, 45 illustrations and 71 of the 376 isometric drawings, as stills in Stroke, Two-tone or your own colours. Anything else comes back with a note saying it needs Pro.

claude mcp add --transport http overflow https://www.overflow.design/api/mcp/

With Pro

Send your licence key as a header, Authorization: Bearer <key>. The key is in the email that came with your receipt.

Keep it in an environment variable rather than in a config file, so a config that ends up in a repository does not carry your licence with it. The examples below read it from OVERFLOW_LICENCE. It is not called OVERFLOW_KEY on purpose: Claude Code blanks any variable with KEY, TOKEN or SECRET in its name when it goes into a header.

Claude Code

claude mcp add --transport http overflow https://www.overflow.design/api/mcp/ \
  --header "Authorization: Bearer $OVERFLOW_LICENCE"

That stores the key in your own settings. To share the server with a project through its .mcp.json, name the variable instead, and each person sets their own:

{
  "mcpServers": {
    "overflow": {
      "type": "http",
      "url": "https://www.overflow.design/api/mcp/",
      "headers": {
        "Authorization": "Bearer ${OVERFLOW_LICENCE}"
      }
    }
  }
}

Cursor

In ~/.cursor/mcp.json:

{
  "mcpServers": {
    "overflow": {
      "url": "https://www.overflow.design/api/mcp/",
      "headers": {
        "Authorization": "Bearer ${env:OVERFLOW_LICENCE}"
      }
    }
  }
}

VS Code

In .vscode/mcp.json. VS Code asks for the key once and keeps it out of the file:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "overflow-licence",
      "description": "Overflow Pro licence key",
      "password": true
    }
  ],
  "servers": {
    "overflow": {
      "type": "http",
      "url": "https://www.overflow.design/api/mcp/",
      "headers": {
        "Authorization": "Bearer ${input:overflow-licence}"
      }
    }
  }
}

Codex

In ~/.codex/config.toml:

[mcp_servers.overflow]
url = "https://www.overflow.design/api/mcp/"
bearer_token_env_var = "OVERFLOW_LICENCE"

Devin Desktop (formerly Windsurf)

In ~/.config/devin/mcp_config.json:

{
  "mcpServers": {
    "overflow": {
      "serverUrl": "https://www.overflow.design/api/mcp/",
      "headers": {
        "Authorization": "Bearer ${env:OVERFLOW_LICENCE}"
      }
    }
  }
}

OpenCode

In opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "overflow": {
      "type": "remote",
      "url": "https://www.overflow.design/api/mcp/",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:OVERFLOW_LICENCE}"
      }
    }
  }
}

Any other client that speaks MCP over Streamable HTTP needs the same two things: the address, and the header.

Then ask for what you need

No tool names needed. Say what you want in your own words, and name Overflow so the agent knows where to look:

  • Add an Overflow calendar icon next to the date field.
  • Find an Overflow illustration for the newsletter signup section and save it with our other images.
  • Show me three Overflow icons that could stand for a user profile, and let me pick.
  • Use the Overflow isometric database drawing in the hero, dark theme.
  • Make the crate in the pricing section the animated Overflow one.
  • Give our support bot the Overflow capybara avatar, with a picture for each state it can be in.

Teach your agent the rules

The server comes with a short set of rules: search before guessing, ask when several drawings fit, fetch them in one go, use each drawing as delivered, and stop once it is in place. In Claude Code, /mcp__overflow__start loads them into the conversation, followed by the task if you like; other clients list it as “Use Overflow Design drawings”.

To have every session follow them, add them to your project's AGENTS.md or CLAUDE.md:

curl -fsSL https://www.overflow.design/mcp/agents.md >> AGENTS.md

Read the rules

# Overflow Design drawings

This project can use Overflow Design's icons, illustrations, isometric drawings and bot avatars through the Overflow MCP server at https://www.overflow.design/api/mcp/ (tools: search_drawings, get_drawings, list_sets). Setup: https://www.overflow.design/mcp/

## When

- When the work needs an icon, an illustration, an isometric drawing or a face for an AI agent, search Overflow before drawing one yourself or taking one from another set.

## How

1. Search with the plain noun: calendar, shopping cart, teamwork. Take ids from the results; never guess one.
2. If the request is vague, or several drawings fit it equally well, show the user two or three, with their names and page links, and let them choose. Otherwise take the best match.
3. Fetch everything you need in one get_drawings call, up to 20 ids.
4. Put each drawing where this project keeps its icons or images, under the file name the result gives, or paste the markup where it is used. For a large file, run the curl command the result gives rather than retyping the markup.
5. Use each drawing as delivered. Do not redraw, simplify or restyle it. Size it with width and height or CSS; icons take their colour from the text around them.
6. Once the drawings are in place, stop. Do not fetch them again to check them.

## Avatars

An avatar is an animal to use as the face of an AI agent. Search for the animal, or for the agent's job and the word avatar. avatar/penguin is the 3D one, a transparent PNG, and avatar/penguin-mini is the pixel-art one, an SVG. Each comes in seven states; ask get_drawings for the ones this project shows, with the states option, rather than for all of them. The 3D ones are 512 wide unless you ask for 1024. Every avatar needs a Pro licence key.

## Locked drawings

Drawings marked locked need a Pro licence key, which the MCP client sends as the header "Authorization: Bearer <key>". If one is locked, say so and offer a free alternative (search_drawings with tier "free"). Do not retry.

## Licence

Licence: these drawings are for use inside this project and what it becomes, client work included. Do not publish the files on their own: not in a public repository, a shared folder or an asset pack. With Pro, icons and illustrations may also go into templates, themes and UI kits you sell, as part of the design rather than a set of their own. If this project's repository is public, free drawings may go into it as part of the project; ask before committing a Pro one. Terms: https://www.overflow.design/license/#ai-coding-agents

What your agent can do

  • search_drawings finds drawings by what they show, across the icons, illustrations, isometric drawings and bot avatars, and says which ones your key opens.
  • get_drawings fetches up to twenty at a time. Icons and most isometric stills come back as SVG or JSX to write into a file or a component, the isometric ones in any of the set page's six styles, facing either way. Illustrations and the larger and animated isometric drawings, which run to tens of kilobytes, come back as a link the agent downloads within fifteen minutes, so the file goes to your disk without passing through the model. A bot avatar comes in any of its seven states: the 3D ones as a transparent PNG by the same kind of link, the pixel-art minis as SVG or JSX.
  • list_sets lists the sets and their categories, and what your key unlocks.

What the licence covers

A drawing your agent fetches is the same drawing, under the same licence, as one you download here. Use it in the project and whatever the project becomes, client work included. Do not publish the files on their own: not in a public repository, a shared folder or an asset pack. With Pro, icons and illustrations may also go into templates, themes and UI kits you sell, as part of the design rather than a set of their own. Free drawings may also go into an open-source project's public repository, as part of the project; a Pro drawing committed there is published, which the licence does not allow. The licence has the details.

Limits

One licence can fetch 30 Pro drawings a minute through the server, which is more than a project needs at once; the whole set is one zip, from Download everything on the pricing page once your key is in. If your key ends up somewhere public, get in touch through the chat on any page and it can be withdrawn and replaced.

Pro is $99 once, for every drawing on the site and every one added later. See what is in it.