# Streamline MCP Server

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/webalys-hq/streamline-mcp-server  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/streamline-mcp-server

## Description
The Streamline MCP Server allow users to search, and download assets in PNG or SVG formats.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "streamline-mcp-server": {
    "command": "npx",
    "args": ["-y","streamline-mcp-server"]
  }
}
```

## Documentation & 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.