Streamline MCP Server
Search and download icons, illustrations, elements and emojis in PNG or SVG formats.
Open source Repository Open in the app JSON README (API)
About
Search and download icons, illustrations, elements and emojis in PNG or SVG formats.
Details
- Kind
- MCP servers
- Topic
- Media, design & games
- Publisher
- com.streamlinehq
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 2.0.0
- Last push
- 2026-07-28T14:28:25Z
- Repository state
- ativo
- Added
- 2026-08-29 03:01:23
- Updated
- 2026-08-29 03:01:23
- Origin id
com.streamlinehq/mcp
README
# Streamline MCP Server
The **Streamline MCP Server** provides a set of tools for MCP-compatible clients such as **Cursor** or **Claude Desktop** to access [Streamline’s](https://www.streamlinehq.com/icons) complete collection of **icons, illustrations, elements, and emojis**.
Clients can **search, retrieve, and download** assets in **PNG** or **SVG** formats.
---
## 🧩 **Setup & Authentication**
The Streamline MCP Server is available at:
```
https://public-api.streamlinehq.com/mcp
```
There are two ways to authenticate. Pick the one that matches your client.
### 🔐 Option 1 — OAuth (recommended for Claude Desktop & Web)
GUI clients that support custom connectors can authenticate with **OAuth** — no API key to copy or store.
1. In Claude, go to **Settings → Connectors → Add custom connector**.
2. Give it a name (e.g. `Streamline MCP`) and enter the server URL above.
3. Click **Connect** — you'll be redirected to the Streamline web app to sign in and grant access.
4. Back in **Settings → Connectors**, confirm the server shows a **Connected** status.
See the [Claude connector guide](https://docs.streamlinehq.com/reference/claude) for full details.
### 🔑 Option 2 — API key (`X-API-Key` header)
Config- or CLI-based clients (e.g. Cursor, Claude Code CLI) authenticate with an API key.
Generate and manage keys from your [**Streamline Account → API Settings**](https://www.streamlinehq.com/profile?tab=api_keys) page.
**JSON config:**
```json
{
"mcpServers": {
"streamline": {
"url": "https://public-api.streamlinehq.com/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY_HERE"
}
}
}
}
```
**Claude Code CLI:**
```bash
claude mcp add --transport http streamline-mcp \
https://public-api.streamlinehq.com/mcp \
--header "X-API-Key: YOUR_API_KEY_HERE"
```
---
## ⚙️ **Usage**
Once connected, your client’s AI chat can call any of the tools below. For full parameters and examples, see the [**Streamline MCP reference**](https://docs.streamlinehq.com/reference/mcp).
> **Terminology:** a **Family** is a top-level bundle (e.g. “Ultimate”), and a **Set** is a style variant within a Family (e.g. “Ultimate Regular”).
### 🔎 Search & discovery
- **`search_assets`** — Search individual icons, illustrations, elements, and emojis across the catalog, or scoped to a specific Set or Family.
- **`search_sets`** — Search Sets (style variants) by phrasing or theme.
- **`find_sets_by_name`** — Look up Sets by name.
- **`get_all_families`** — Browse every Family (bundle) available to your account.
- **`get_all_sets_from_family`** — List all Sets within a given Family.
- **`get_family_extra_details`** — Fetch descriptions and semantic context for a Family.
### 📥 Retrieve & download
- **`get_icon_by_hash`** — Retrieve a specific icon by its unique hash.
- **`download_asset`** — Download a single asset in **PNG** or **SVG** with size, color, background, and stroke options.
- **`download_multiple_assets`** — Batch-download several assets in one call.
**Example:**
Ask your client’s AI chat to **search for “dog icons.”**
The MCP client will automatically call the appropriate tool and return matching results from Streamline.
---
## 🌟 **Key Features**
- Search icons, illustrations, elements, and emojis.
- Retrieve detailed metadata about specific assets.
- Download assets in **PNG** or **SVG** formats with customization options (size, color, background, stroke).
- Fully compatible with all **MCP protocol** clients.
---
## 💡 **Use Cases**
- Quickly find icons for web or mobile design projects.
- Retrieve and customize assets for design systems or creative workflows.
- Automate icon-related tasks in your apps or build tools.
---
## ❓ **FAQ**
**Which clients can use Streamline MCP Server?**
> Any MCP-compatible client (e.g., Cursor, Claude Desktop) can connect via the provided JSON-RPC endpoint.
**Can I download icons in multiple formats?**
> Yes, both PNG and SVG are supported, with options for size and color customization.
**Do I need authentication?**
> Yes. You can authenticate either via **OAuth** (recommended for Claude Desktop/Web) or with an **API key** (`X-API-Key` header for CLI/config clients)—see the [Setup & Authentication](#setup--authentication) section for details.
---
## 🙋 **Need help?**
Want direct access to the Streamline dev team? Join our [**public Slack channel**](https://go.streamlinehq.com/mcp-support) to ask questions, share feedback, and get help setting up the MCP server straight from the people building it.