Streamline MCP Server

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 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 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 page.

JSON config:

{
  "mcpServers": {
    "streamline": {
      "url": "https://public-api.streamlinehq.com/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Claude Code CLI:

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.

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 section for details.

---

🙋 Need help?

Want direct access to the Streamline dev team? Join our public Slack channel to ask questions, share feedback, and get help setting up the MCP server straight from the people building it.