---
title: "Favicon API & MCP Server for AI Agents | Favicon Generator"
description: "Free favicon MCP server, REST API, WebMCP browser tools and agent skill. Generate favicon.svg, the HTML head snippet and site.webmanifest from text, emoji or open-source icons. No key, CORS enabled."
url: https://favicongenerator.io/developers
---

For AI agents and developers

# Favicon API and MCP server

The favicon logic behind this site, as tools an agent can call: build favicon.svg from text, an emoji or an open-source icon, and get the HTML <head> snippet, site.webmanifest and platform install steps. Free and read-only. No key, no sign-up, CORS enabled.

## 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](https://favicongenerator.io/) , 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](https://favicongenerator.io/llms-full.txt) . Machine-readable card: [/.well-known/mcp/server-card.json](https://favicongenerator.io/.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 ( [/](https://favicongenerator.io/) , [/text](https://favicongenerator.io/text) , [/emoji](https://favicongenerator.io/emoji) , [/image](https://favicongenerator.io/image) , [/svg](https://favicongenerator.io/svg) , [/code](https://favicongenerator.io/code) , [/icon](https://favicongenerator.io/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](https://favicongenerator.io/.well-known/agent-skills/create-favicon/SKILL.md) 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](https://favicongenerator.io/.well-known/agent-skills/index.json) lists it with its SHA-256 digest.

## Discovery files

- [/llms.txt](https://favicongenerator.io/llms.txt) and [/llms-full.txt](https://favicongenerator.io/llms-full.txt) : site map and full reference for language models
- [/.well-known/api-catalog](https://favicongenerator.io/.well-known/api-catalog) : RFC 9727 API catalog
- [/.well-known/mcp/server-card.json](https://favicongenerator.io/.well-known/mcp/server-card.json) : MCP server card
- [/.well-known/ai-catalog.json](https://favicongenerator.io/.well-known/ai-catalog.json) : ARD capability manifest
- [/.well-known/agent-skills/index.json](https://favicongenerator.io/.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](https://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](mailto:hello@favicongenerator.io) .

Markdown view of https://favicongenerator.io/developers. Favicon API, MCP server and agent docs: https://favicongenerator.io/developers