Icons8 MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Icons8 MCP or direct API to browse icon metadata, search categories, inspect supported platforms, and retrieve licensed SVG source through natural language.

Icons8 logoIcons8
Api Key

Icons8 is a design asset platform with searchable icons, metadata, categories, and SVG resources. Its API helps developers find the right icons and retrieve licensed SVG source efficiently.

5 Tools

Try Icons8 now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Icons8
Try asking
TOOLS

Supported Tools

Every Icons8 action and event your agent gets out of the box.

Get Icon Metadata

Return metadata for one Icons8 icon without SVG source or download-allocation use.

Get Icon SVG

Return one icon's metadata and SVG source as untrusted text.

List Icon Categories

Return one bounded page of Icons8 icon categories, nested subcategories, icon counts, a relative share-preview path, and style-specific preview icon names.

List Icon Platforms and Styles

Return one bounded page of Icons8 platform/style codes, names, color and size metadata, icon counts, preview icon names, and a preview URL.

Search Icons

Return one bounded page of Icons8 icon metadata filtered by style, category, language, explicit-content inclusion, and animation state.

SETUP GUIDE

Connect Icons8 MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["icons8"],
  mcp: true,
});
Create a session scoped to Icons8 and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Find the Icons8 icon named home, show its metadata and available platforms, and retrieve its licensed SVG source.",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Icons8 request
SETUP GUIDE

Connect Icons8 API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["icons8"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Icons8
3

Run Icons8 tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Find the Icons8 icon named home, show its metadata and available platforms, and retrieve its licensed SVG source." }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Icons8 tool calls through the session, and print the final answer

Why Use Composio?

AI Native Icons8 Integration

  • Supports both Icons8 MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for browsing icon metadata, categories, platforms, and SVG source

Managed Auth

  • Securely connect your Icons8 API key without hard-coding credentials in agent code
  • Central place to manage, scope, and revoke Icons8 access
  • Per user and per environment credentials for safer development and deployment

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Clear schemas help agents choose the right Icons8 operation and provide useful results
  • Comprehensive execution logs show what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Icons8
  • Scoped, least privilege access to Icons8 resources
  • Full audit trail of agent actions to support review and compliance
FRAMEWORKS

Use Icons8 with any AI Agent Framework

Choose a Framework you want to connect Icons8 with

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Start with Icons8.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Icons8 tool your agent needs.Free to start.

Start building