{
  "markdown": "# Streamline MCP Server\n\nThe **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**.  \nClients can **search, retrieve, and download** assets in **PNG** or **SVG** formats.\n\n---\n\n## 🧩 **Setup & Authentication**\n\nThe Streamline MCP Server is available at:\n\n```\nhttps://public-api.streamlinehq.com/mcp\n```\n\nThere are two ways to authenticate. Pick the one that matches your client.\n\n### 🔐 Option 1 — OAuth (recommended for Claude Desktop & Web)\n\nGUI clients that support custom connectors can authenticate with **OAuth** — no API key to copy or store.\n\n1. In Claude, go to **Settings → Connectors → Add custom connector**.\n2. Give it a name (e.g. `Streamline MCP`) and enter the server URL above.\n3. Click **Connect** — you'll be redirected to the Streamline web app to sign in and grant access.\n4. Back in **Settings → Connectors**, confirm the server shows a **Connected** status.\n\nSee the [Claude connector guide](https://docs.streamlinehq.com/reference/claude) for full details.\n\n### 🔑 Option 2 — API key (`X-API-Key` header)\n\nConfig- or CLI-based clients (e.g. Cursor, Claude Code CLI) authenticate with an API key.  \nGenerate and manage keys from your [**Streamline Account → API Settings**](https://www.streamlinehq.com/profile?tab=api_keys) page.\n\n**JSON config:**\n\n```json\n{\n  \"mcpServers\": {\n    \"streamline\": {\n      \"url\": \"https://public-api.streamlinehq.com/mcp\",\n      \"headers\": {\n        \"X-API-Key\": \"YOUR_API_KEY_HERE\"\n      }\n    }\n  }\n}\n```\n\n**Claude Code CLI:**\n\n```bash\nclaude mcp add --transport http streamline-mcp \\\n  https://public-api.streamlinehq.com/mcp \\\n  --header \"X-API-Key: YOUR_API_KEY_HERE\"\n```\n\n---\n\n## ⚙️ **Usage**\n\nOnce 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).\n\n> **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”).\n\n### 🔎 Search & discovery\n\n- **`search_assets`** — Search individual icons, illustrations, elements, and emojis across the catalog, or scoped to a specific Set or Family.\n- **`search_sets`** — Search Sets (style variants) by phrasing or theme.\n- **`find_sets_by_name`** — Look up Sets by name.\n- **`get_all_families`** — Browse every Family (bundle) available to your account.\n- **`get_all_sets_from_family`** — List all Sets within a given Family.\n- **`get_family_extra_details`** — Fetch descriptions and semantic context for a Family.\n\n### 📥 Retrieve & download\n\n- **`get_icon_by_hash`** — Retrieve a specific icon by its unique hash.\n- **`download_asset`** — Download a single asset in **PNG** or **SVG** with size, color, background, and stroke options.\n- **`download_multiple_assets`** — Batch-download several assets in one call.\n\n**Example:**  \nAsk your client’s AI chat to **search for “dog icons.”**  \nThe MCP client will automatically call the appropriate tool and return matching results from Streamline.\n\n---\n\n## 🌟 **Key Features**\n\n- Search icons, illustrations, elements, and emojis.\n- Retrieve detailed metadata about specific assets.\n- Download assets in **PNG** or **SVG** formats with customization options (size, color, background, stroke).\n- Fully compatible with all **MCP protocol** clients.\n\n---\n\n## 💡 **Use Cases**\n\n- Quickly find icons for web or mobile design projects.\n- Retrieve and customize assets for design systems or creative workflows.\n- Automate icon-related tasks in your apps or build tools.\n\n---\n\n## ❓ **FAQ**\n\n**Which clients can use Streamline MCP Server?**\n\n> Any MCP-compatible client (e.g., Cursor, Claude Desktop) can connect via the provided JSON-RPC endpoint.\n\n**Can I download icons in multiple formats?**\n\n> Yes, both PNG and SVG are supported, with options for size and color customization.\n\n**Do I need authentication?**\n\n> 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.\n\n---\n\n## 🙋 **Need help?**\n\nWant 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.\n",
  "bytes": 4560,
  "sha": "31d6f87cd88eed8c0d479e7868280dce1f86ad99a6ad69f9be4672dc7d07726f",
  "repo_slug": "webalys-hq/streamline-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_streamlinehq_mcp_79234a68/readme"
}