Access

Interface	Address	Notes
MCP server	`https://favicongenerator.io/mcp`	Streamable HTTP, POST only, JSON responses, no session, no auth
REST API	`https://favicongenerator.io/api`	GET only, JSON or SVG, CORS `*`
OpenAPI 3.1	`https://favicongenerator.io/api/openapi.json`	Every endpoint and parameter
WebMCP	Every generator page	Browser agents drive the generator on the open page
Agent skill	`/.well-known/agent-skills/create-favicon/SKILL.md`	Step-by-step instructions for coding agents
Markdown pages	`Accept: text/markdown` or a `.md` URL	For example `/text.md`; `/index.md` for the home page

The server returns favicon.svg as text plus the install code. It does not render PNG or ICO files: an agent converts the SVG locally (the tool result includes the commands), or sends the user to the generator, which builds every file in the browser and downloads one ZIP.

MCP server

Endpoint https://favicongenerator.io/mcp. It speaks the stateless 2026-07-28 revision (per-request _meta, server/discover) and the earlier initialize-handshake revisions 2025-11-25, 2025-06-18 and 2025-03-26. GET returns 405. Every tool is read-only.

Tools

Tool	What it returns
`generate_text_favicon`	favicon.svg from one or two characters or an emoji on a rounded-square or circle background, with optional dark-mode colors; the HTML snippet; site.webmanifest; conversion commands
`search_icons`	Icon ids from the open-source library (Feather, Lucide, Tabler, Heroicons, custom icons, Unicode symbols), with source and license
`get_icon_svg`	One library icon as a favicon SVG with a fixed color and an optional dark-mode color
`get_install_code`	The HTML <head> snippet, site.webmanifest and the list of favicon files a site needs
`get_platform_guide`	Where to upload which file on WordPress, Webflow, Wix, Shopify, Squarespace, Next.js, static HTML or a PWA

Full argument tables: /llms-full.txt. Machine-readable card: /.well-known/mcp/server-card.json.

Connect an agent

Claude Code

claude mcp add --transport http favicon-generator https://favicongenerator.io/mcp

Codex (~/.codex/config.toml)

[mcp_servers.favicon-generator]
url = "https://favicongenerator.io/mcp"

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "favicon-generator": { "url": "https://favicongenerator.io/mcp" }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "favicon-generator": { "type": "http", "url": "https://favicongenerator.io/mcp" }
  }
}

Gemini CLI (~/.gemini/settings.json)

{
  "mcpServers": {
    "favicon-generator": { "httpUrl": "https://favicongenerator.io/mcp" }
  }
}

Claude Desktop and claude.ai: Settings → Connectors → Add custom connector, then paste https://favicongenerator.io/mcp.

Call it with curl

curl -s https://favicongenerator.io/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2025-06-18' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"generate_text_favicon","arguments":{"text":"A","background_start":"#0f172a","text_color":"#ffffff"}}}'

REST API

Base URL https://favicongenerator.io/api. Every endpoint is a GET that wraps one MCP tool and takes the same arguments as query parameters. URL-encode # in colors as %23. Unknown or invalid arguments return 400 with a message that names the allowed ones.

Endpoint	Returns
`GET /api/text-favicon`	JSON: svg, html, manifest, files, convert_commands
`GET /api/text-favicon.svg`	The favicon.svg file itself
`GET /api/icons`	JSON: icon search results (`query`, `source`, `limit`)
`GET /api/icons/{id}`	JSON: one icon as a favicon SVG (`color`, `dark_color`, `stroke_width`)
`GET /api/icons/{id}.svg`	The icon SVG file itself
`GET /api/install-code`	JSON: HTML snippet, site.webmanifest, file list
`GET /api/platforms/{platform}`	JSON: install steps for one platform
`GET /api/openapi.json`	The OpenAPI 3.1 document

Examples

curl 'https://favicongenerator.io/api/text-favicon?text=A&background_start=%230f172a&text_color=%23ffffff'
curl -o favicon.svg 'https://favicongenerator.io/api/text-favicon.svg?text=%F0%9F%9A%80&background_start=transparent'
curl 'https://favicongenerator.io/api/icons?query=rocket&limit=5'
curl -o favicon.svg 'https://favicongenerator.io/api/icons/rocket.svg?color=%232563eb&dark_color=%2393c5fd'
curl 'https://favicongenerator.io/api/platforms/wordpress'

WebMCP browser tools

Every generator page (/, /text, /emoji, /image, /svg, /code, /icon) registers WebMCP tools on document.modelContext when the browser supports it. A browser agent can then build the full favicon set on the page, including the PNG and ICO files, and download the ZIP.

generate_text_favicon: build the favicon from text or an emoji
search_icons and select_icon: pick a library icon (pages that load the icon library)
load_svg: use SVG markup as the source
get_favicon_files: the generated files, the HTML snippet and favicon.svg
download_favicon_zip: save every file as favicon-package.zip

Agent skill

create-favicon tells a coding agent how to pick a source, call the tools, write the files into the right folder, create the PNG and ICO sizes and paste the head tags. The index at /.well-known/agent-skills/index.json lists it with its SHA-256 digest.

Discovery files

/llms.txt and /llms-full.txt: site map and full reference for language models
/.well-known/api-catalog: RFC 9727 API catalog
/.well-known/mcp/server-card.json: MCP server card
/.well-known/ai-catalog.json: ARD capability manifest
/.well-known/agent-skills/index.json: Agent Skills index
Every HTML page sends a Link header pointing to these files and to its Markdown version.

Usage

Free for personal and commercial use. Icons keep their own licenses (MIT or ISC; Unicode symbols); each result lists the license.
Credit favicongenerator.io where you show a generated favicon or wrap these endpoints in another tool. Results carry a credit field for this.
Server-side callers: send a User-Agent that names your project and a contact, for example myproject/1.0 (+https://myproject.example), and cache results. Identical requests return identical output.
Questions or higher volume: hello@favicongenerator.io.

Favicon API and MCP server