Gentleface icons

● Active

com.gentleface/icons

Find MIT pixel-aligned icons by meaning; get SVG, React, SwiftUI or Compose code.

Connect this server

One click to install, or copy the config below. Suits: Cursor · HTTP clients.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "icons": {
      "url": "https://gentleface.com/mcp"
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --transport http icons https://gentleface.com/mcp
VS Code
code --add-mcp '{"name":"icons","type":"http","url":"https://gentleface.com/mcp"}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in. Codex takes hosted servers in config.toml ([mcp_servers.<name>] url = …) rather than on the command line.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Media & Creative
Version
0.7.0
Registry
active
Published
11/20/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 22, 2026

Looks healthy: Gentleface icons is maintained, open source, hosted endpoint answering without a key.

Maintained
Active
Last commit 3 days ago (Nov 19, 2026), 0 open issues.
Official registry
Active
Published as com.gentleface/icons in the official MCP registry, version 0.7.0.
Source
Open source, MIT
Public repository under the MIT licence, 0 stars, 0 forks.
Runs
Hosted by the publisher
Your client talks to gentleface.com: prompts and tool arguments leave your machine for that host.
Credentials
None needed to connect
The hosted endpoint completed the Serverdex initialize + tools/list handshake with no key (checked Nov 22, 2026); individual tools may still ask for one.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself and see the status history.

Live check

checked Nov 22, 2026, 07:07 UTCStatus history & uptime →
● Working554 msprotocol 2025-06-18v2026-11-18tools

The endpoint answered the MCP handshake as "Gentleface icons" and listed 5 tools. Answering since Nov 21, 2026.

Context cost ≈ 648 tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 5 tools.

Tools (5)

  • search_icons2 params

    Find icons for a meaning or a UI action ("delete", "turn camera off", "invite user"). Ranked by the same engine as gentleface.com: names, meanings, synonyms and user phrasings, with notes on which icon to prefer. Search once per meaning you need.

    Show parameters
    • querystringrequiredWhat the icon should mean or do, in plain words
    • limitinteger
  • get_icon3 params

    One icon in one style and format, with what it means, which icons to use instead, what it is confused with, file URLs (SVG, PNG 16/32/48), its family and, when it has one, its animated version (motion).

    Show parameters
    • namestringrequiredIcon name, kebab-case (from search_icons)
    • stylestring
    • formatstring
  • get_icons3 params

    Up to 30 icons in one style and format in one call: the way to fetch every icon a screen needs once you have picked them.

    Show parameters
    • namesarrayrequired
    • stylestring
    • formatstring
  • The categories of the set, with what each covers and how many icons it has.

  • get_category1 param

    Every icon in one category (slug from list_categories), with what each is for.

    Show parameters
    • slugstringrequired

Checked by Serverdex with a plain initialize + tools/list call to gentleface.com/mcp, no credentials, about once a day. A failed check is never a removal.

On GitHub

read Nov 21, 2026
Stars
0
Forks
0
Last push
Nov 19, 2026
License
MIT

animated-iconsclaude-code-pluginicon-seticonifyiconsmcppixel-perfectreactsvgsvg-icons

From the README

Gentleface icons Free, pixel-aligned icons drawn on the 16 px grid, with separate 20 and 24 px masters. MIT. • 4,035 icons at 16 px in 6 styles: line or solid, with round, soft or sharp corners • 4,031 of them also drawn at 20 px and at 24 px in light, regular and bold • 120,954 SVGs in all, plus 1,000 animated ones • every icon documents what it means and what to use instead Browse, search and copy them at gentleface.com. Install Usage The SVGs use currentColor. Keep each icon at its own size or an exact multiple (16, 32, 48) on whole pixels; a fractional size or position blurs it. For a 20 or 24 px UI, use the icons drawn for that grid instead of scaling the 16 px ones. In this repository Styles: line-round, line-soft, line-sharp, solid-round, solid-soft, solid-sharp. For coding agents The Claude Code plugin adds the Gentleface MCP server (search icons by meaning, get them as React, SwiftUI, Compose or SVG code) and a skill that keeps one meaning per icon across a project. Other agents: gentleface.com/agents. Feedback Missing icon or a wrong meaning: gentleface.com/feedback. Problems with this repository or the packages: open an issue. See CONTRIBUTING.md. License MIT. Drawn with Claude Code; art direction by Alex Kiselev, who reviewed every icon.

Read the full README on GitHub →

Remotes

  • streamable-httphttps://gentleface.com/mcp

The most-starred Media & Creative servers in the index, with their live-check result.

ServerStarsLast pushLive check
HyperFrames by HeyGen87,943Nov 2026Needs sign-in
HyperFrames by HeyGen86,475Nov 2026Needs sign-in
Pascal 3D Editor25,651Nov 2026Needs sign-in
screenpipe22,421Nov 2026Local / not checked
FunASR21,097Nov 2026Local / not checked

Gentleface icons: questions people ask

Is Gentleface icons a remote or a local MCP server?
According to its entry in the official MCP registry, Gentleface icons ships as a hosted endpoint (streamable-http) that your client connects to by URL.
Does Gentleface icons need an API key?
Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 22, 2026. Individual tools may still ask for a key when called.
Is Gentleface icons safe to use?
Looks healthy: Gentleface icons is maintained, open source, hosted endpoint answering without a key. In detail — maintained: Active; official registry: Active; source: Open source, MIT; runs: Hosted by the publisher; credentials: None needed to connect. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is Gentleface icons still maintained?
Active: the repository's last commit 3 days ago. Last push Nov 19, 2026, 0 GitHub stars, MIT licence. Read from GitHub on Nov 21, 2026.
What tools does Gentleface icons expose?
5 tools as listed by the server itself during the live check, including search_icons, get_icon, get_icons, list_categories, get_category. The full list with parameters is in the Live check section above.
How do I add Gentleface icons to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
Browse all Media & Creative →

Add the badge to your site

Show visitors that Gentleface icons is listed here — it’s also the link we check for a free listing.

Gentleface icons — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/com-gentleface-icons?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Gentleface icons — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Gentleface icons — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/com-gentleface-icons?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/com-gentleface-icons) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/com-gentleface-icons) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/com-gentleface-icons)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/com-gentleface-icons"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/com-gentleface-icons"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/com-gentleface-icons"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).