# Devicons — agent readiness

Devicons is a free, MIT-licensed library of 1,322 developer, brand, framework, and tooling logos. Agents can search it, fetch SVGs, and generate React, Vue, or Svelte code through any of the surfaces below. Everything is read-only and needs no API key.

## Surfaces

| Surface | Entry point | Docs |
| --- | --- | --- |
| MCP (hosted) | `https://devicons.io/api/mcp` (Streamable HTTP, stateless) | [https://devicons.io/docs/mcp/](https://devicons.io/docs/mcp/) |
| MCP (local stdio) | `npx -y devicons mcp` | [https://devicons.io/docs/mcp/](https://devicons.io/docs/mcp/) |
| HTTP API | `https://devicons.io/api/v1/` | [https://devicons.io/docs/api/](https://devicons.io/docs/api/) |
| OpenAPI 3.1 | `https://devicons.io/api/v1/openapi.json` | — |
| CLI | `npx devicons search <query>` | [https://devicons.io/docs/cli/](https://devicons.io/docs/cli/) |
| Skill | `https://devicons.io/skill.md` | [https://devicons.io/docs/skill/](https://devicons.io/docs/skill/) |
| llms.txt | `https://devicons.io/llms.txt`, `https://devicons.io/llms-full.txt` | — |

MCP tools: `search_icons`, `get_icon`, `list_categories`, `get_category`.

Quick start for Claude Code:

```bash
claude mcp add --transport http devicons https://devicons.io/api/mcp
```

## Discovery

- MCP server card: https://devicons.io/.well-known/mcp.json
- API catalog (RFC 9727): https://devicons.io/.well-known/api-catalog
- Agent Skills index: https://devicons.io/.well-known/agent-skills/index.json
- Every HTML page has a Markdown twin (`/icons/react.md`) and answers `Accept: text/markdown`.

## Limits and terms

- Read-only and unauthenticated. Responses are cached at the edge; please cache on your side too.
- Requests may be rate limited per IP; a 429 means back off and retry later.
- SVG files and packages are MIT licensed. Logos are trademarks of their owners; follow each brand's guidelines.
- Don't use the API to rebuild a competing icon catalog. It's meant for tools, plugins, and agents that help people use these logos.