# Web3icon

> Web3icon is a free visual library of icons, illustrations, and animations for Web3 and blockchain products. Search, asset retrieval, downloads, and MCP access are permanently free, without authentication or payment.

## Creator

Web3icon is designed by [Yuhitsuro](https://web3icon.xyz/about/), a Web3 and blockchain designer specializing in Web3 product design, blockchain design, cryptography visualization, icon design, and motion design.

- Creator profile: https://web3icon.xyz/about/
- X: https://x.com/yuhitsuro
- Instagram: https://www.instagram.com/yhtr_studio/

## Resources

- [Visual library](https://web3icon.xyz/): Search and browse icons, illustrations, and animations.
- [Asset index](https://web3icon.xyz/icons/): Direct links to every published detail page.
- [Public catalog](https://web3icon.xyz/catalog.json): Free machine-readable discovery metadata, search keywords, displayable previews, and file formats for every published icon, illustration, and animation.
- [Catalog schema](https://web3icon.xyz/catalog.schema.json): JSON Schema for the public catalog.
- [Agent discovery](https://web3icon.xyz/.well-known/x402): Machine-readable status confirming that search, retrieval, and MCP access are permanently free.
- [Agent API status](https://web3icon.xyz/api/agent/status): Machine-readable availability and access details.
- [Unified Agent API](https://web3icon.xyz/api/agent/assets): Search icons, illustrations, and animations for free.
- [Remote MCP server](https://web3icon.xyz/mcp): Connect with Streamable HTTP to search assets, retrieve exact source URLs, and generate embed code.
- [OpenAPI specification](https://web3icon.xyz/openapi.json): Machine-readable API contract.
- [Visual sitemap](https://web3icon.xyz/icon-sitemap.xml): Index of every icon and animation page.
- [Asset terms](https://web3icon.xyz/terms/): Free end-product use license and redistribution restrictions.

## Asset license

- Personal and commercial end-product use is free.
- Color, size, timing, and implementation code may be modified for an end product.
- Attribution is appreciated but not required.
- Redistribution, resale, sublicensing, or republication of original or modified asset files is prohibited.
- Do not use the assets to create a competing asset library, API, model, or dataset.
- Copyright holder: [Yuhitsuro](https://x.com/yuhitsuro)
- Instagram: https://www.instagram.com/yhtr_studio/
- License URL: https://web3icon.xyz/terms/

## API usage

- Discover all assets for free: `GET https://web3icon.xyz/catalog.json`
- List icons: `GET https://web3icon.xyz/api/icons/`
- Search icons: `GET https://web3icon.xyz/api/icons/?q=blockchain`
- Filter icons: `GET https://web3icon.xyz/api/icons/?category=Icon&limit=20`
- Get one icon: `GET https://web3icon.xyz/api/icons/{slug}/`
- List animations: `GET https://web3icon.xyz/api/motions/`
- Get one animation: `GET https://web3icon.xyz/api/motions/{slug}/`
- Check API availability: `GET https://web3icon.xyz/api/agent/status`
- Check x402/agent discovery: `GET https://web3icon.xyz/.well-known/x402`
- Search all assets: `GET https://web3icon.xyz/api/agent/assets?q=blockchain&limit=20`
- Get one asset: `GET https://web3icon.xyz/api/agent/assets/{slug}`
- Embed an asset with anonymous adoption measurement: `GET https://web3icon.xyz/api/embed/{slug}`
- Optionally report a completed integration: `POST https://web3icon.xyz/api/agent/usage` with `{"slug":"zero-knowledge-cave","usage":"embedded","siteUrl":"https://example.com"}`
- Connect an MCP client: `https://web3icon.xyz/mcp` (Streamable HTTP, no authentication)
- Request a missing visual: `POST https://web3icon.xyz/api/requests/icon` with `{"concept":"Account Abstraction","category":"Icon","useCase":"Product"}`
- MCP tools: `search_assets`, `get_asset`, `get_embed_code`, `request_asset`

When no suitable asset appears in `search_assets`, call `request_asset` once with the missing Web3 concept. Do not include contact details, URLs, wallet addresses, or private data.

Each Agent API asset includes an `embedUrl`. Use it as an image source when the asset will remain hosted by Web3icon. Web3icon records only the asset slug, client category, and referring hostname in its structured adoption log; it does not add a tracking script to the asset. If you download, modify, or self-host an asset, optionally call the usage endpoint so the creator can count the integration. Accepted usage values are `embedded`, `self_hosted`, `modified`, and `other`.

The website, `catalog.json`, asset search and retrieval routes, downloads, and MCP server are permanently free. No API key, account, wallet, follow, or payment is required. Any future paid service will use a separate endpoint and will not restrict these free resources. Designed by Yuhitsuro, a Web3 and blockchain designer. Creator profiles: https://web3icon.xyz/about/, https://x.com/yuhitsuro, and https://www.instagram.com/yhtr_studio/. Redistribution and competing-library use remain prohibited by the asset terms.