asset-finder-mcp
Provides tools for searching and retrieving icons from Iconify's library of 200,000+ open-source UI icons, including filtering by style and license.
Enables searching and retrieving stock photos from Pexels' library of free-to-use photography, with metadata like dimensions and license info.
Enables searching and retrieving stock photos and vectors from Pixabay's collection, with filtering by type and license.
Enables searching and retrieving stock photos from Unsplash's library, with metadata for dimensions and the Unsplash license.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@asset-finder-mcpsuggest an asset for a settings gear icon"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Asset Finder MCP
The all-in-one asset search MCP server for AI coding agents
Find icons, logos, stock photos, vectors, and emoji — all from a single tool call.
Why?
AI coding agents (Cursor, Claude Code, Windsurf, Cline) build UIs every day — but when they need an icon, a logo, or a stock photo, the human has to go find it manually. Asset Finder MCP fixes this. Your AI agent can now search 700,000+ assets and pick the right one, in real-time, without leaving the editor.
Related MCP server: PickAPIcon MCP
What It Does
Tool | Description | Sources |
| Search 200,000+ UI icons | Iconify |
| Find brand & company logos | Logo.dev |
| Search free stock photography | Pexels, Unsplash, Pixabay |
| Search 500,000+ SVG vectors | SVG Repo |
| Search open-source emoji | OpenMoji |
| Describe what you need → get ranked matches | All sources |
| Get full details for a specific asset | All sources |
| Show available asset sources | — |
Quick Start
One-line install (no API keys needed):
{
"mcpServers": {
"asset-finder": {
"command": "npx",
"args": ["-y", "asset-finder-mcp"]
}
}
}That's it. The server starts immediately with 3 free providers (Iconify, SVG Repo, OpenMoji) — no signup, no keys, no config.
With stock photos and logos (optional API keys):
{
"mcpServers": {
"asset-finder": {
"command": "npx",
"args": ["-y", "asset-finder-mcp"],
"env": {
"PEXELS_API_KEY": "your-key",
"UNSPLASH_ACCESS_KEY": "your-key",
"PIXABAY_API_KEY": "your-key",
"LOGO_DEV_TOKEN": "your-token"
}
}
}
}Get free API keys:
Pexels — https://www.pexels.com/api/
Unsplash — https://unsplash.com/developers
Pixabay — https://pixabay.com/api/docs/
Logo.dev — https://logo.dev
Install in Your Editor
Edit claude_desktop_config.json:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"asset-finder": {
"command": "npx",
"args": ["-y", "asset-finder-mcp"]
}
}
}Create .cursor/mcp.json in your project root:
{
"mcpServers": {
"asset-finder": {
"command": "npx",
"args": ["-y", "asset-finder-mcp"]
}
}
}Edit ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"asset-finder": {
"command": "npx",
"args": ["-y", "asset-finder-mcp"]
}
}
}Add to your MCP settings:
{
"mcpServers": {
"asset-finder": {
"command": "npx",
"args": ["-y", "asset-finder-mcp"]
}
}
}git clone https://github.com/Erfangit23/asset-finder-mcp.git
cd asset-finder-mcp
npm install
npm run build
npm startThe suggest_asset Tool (The Killer Feature)
Instead of knowing which tool to call, just describe what you need:
"suggest_asset" with description: "modern minimalist icon for a settings menu, blue color"
→ searches Iconify + SVG Repo, returns ranked results
"suggest_asset" with description: "Stripe company logo"
→ searches Logo.dev, returns the Stripe logo
"suggest_asset" with description: "professional headshot photo for a team page"
→ searches Pexels + Unsplash + Pixabay, returns photos
"suggest_asset" with description: "cute cat emoji"
→ searches OpenMoji, returns matching emojiThe tool auto-detects the asset type from your description and searches the right providers.
Example: AI Agent Workflow
You ask Cursor: "Build a settings page with a gear icon and a mountain background image"
Cursor calls:
suggest_asset("gear settings icon")→ gets SVG icon URLCursor calls:
suggest_asset("mountain landscape background")→ gets stock photo URLCursor writes: The full HTML/CSS with real assets embedded — no placeholders
Asset Catalog
Source | Type | Count | API Key | License |
Iconify | Icons | 200,000+ | No | Various (per icon set) |
SVG Repo | Vectors | 500,000+ | No | Various (CC0, CC-BY, etc.) |
OpenMoji | Emoji | 4,000+ | No | CC BY-SA 4.0 |
Pexels | Stock Photos | Millions | Yes | Free for commercial use |
Unsplash | Stock Photos | Millions | Yes | Unsplash License |
Pixabay | Photos & Vectors | 2M+ | Yes | Pixabay Content License |
Logo.dev | Brand Logos | 50,000+ | Yes | Free for commercial use |
Features
Zero-config start — works immediately with 3 free providers, no signup
Multi-source aggregation — one tool call, results from all providers
AI-friendly output — license info, dimensions, format, tags in every result
License-aware filtering — filter by MIT, CC0, CC-BY, commercial-use, etc.
Smart suggestion — describe in natural language, get the right asset type
In-memory caching — LRU cache reduces API calls and latency
TypeScript — fully typed, declaration files included
Tested — unit tests for cache, normalization, and filtering
Project Structure
asset-finder-mcp/
├── src/
│ ├── index.ts # MCP server entry point
│ ├── config.ts # Environment config loader
│ ├── types.ts # Shared type definitions
│ ├── tools/
│ │ ├── search-tools.ts # search_icons, search_logos, search_stock_photos, search_vectors, search_emoji
│ │ ├── suggest-asset.ts # suggest_asset (smart multi-provider search)
│ │ ├── get-asset.ts # get_asset (fetch by ID)
│ │ └── list-providers.ts # list_providers (show available sources)
│ ├── providers/
│ │ ├── iconify.ts # 200k+ icons (free, no key)
│ │ ├── svgrepo.ts # 500k+ SVG vectors (free, no key)
│ │ ├── openmoji.ts # Open-source emoji (free, no key)
│ │ ├── pexels.ts # Stock photos (free, key needed)
│ │ ├── unsplash.ts # Stock photos (free, key needed)
│ │ ├── pixabay.ts # Photos & vectors (free, key needed)
│ │ └── logo-dev.ts # Brand logos (free, token needed)
│ └── utils/
│ ├── cache.ts # LRU cache
│ ├── normalize.ts # Result normalization & AI formatting
│ └── license-filter.ts # License/format/color filtering
├── tests/
│ ├── cache.test.ts
│ ├── normalize.test.ts
│ └── license-filter.test.ts
├── examples/
│ ├── claude-desktop.json
│ ├── cursor-config.json
│ └── windsurf-config.json
├── docs/
│ ├── INSTALL.md
│ └── PROVIDERS.md
├── .github/workflows/ci.yml
├── .env.example
├── package.json
├── tsconfig.json
└── LICENSEContributing
Contributions are welcome! Here's how to add a new provider:
Create
src/providers/your-provider.tsimplementing theProviderinterfaceRegister it in
src/index.tsAdd tests
Update
docs/PROVIDERS.mdSubmit a PR
License
MIT — see LICENSE
Links
MCP Specification: https://modelcontextprotocol.io
MCP SDK: https://github.com/modelcontextprotocol/typescript-sdk
Report an issue: https://github.com/Erfangit23/asset-finder-mcp/issues
If this project helped you, give it a star!
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityDmaintenanceA search service based on multiple image APIs and icon generation capabilities, specifically designed for integration with Cursor MCP service. Supports image search, download, and AI-generated icons.Last updated16MIT
- AlicenseBqualityDmaintenanceMCP server that allows FE/UI/Designers to retrieve SVG icons via the Iconify API by simply asking LLMs rather than manually searching websites.Last updated31044MIT
- Alicense-qualityDmaintenanceTool search engine for AI agents. One API call to discover the best MCP server for any task. 900+ services indexed with 4-dimensional value ranking.Last updatedMIT
- AlicenseAqualityCmaintenanceMCP server that allows AI coding agents to search, download, and convert stock photos from Pexels, Unsplash, and Pixabay into WebP format for direct use in web development projects.Last updated3212MIT
Related MCP Connectors
Multilingual semantic SVG icon search with previews for AI coding agents. 20,000+ icons.
Icons for agentic development: search & fetch 366,000+ open-source icons as SVG/PNG. No API key.
Search a curated directory of 300+ verified AI agents, MCP servers, and agentic tools.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Erfangit23/asset-finder-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server