---
name: "xpay-icons8"
description: "Search and browse icons, illustrations, and design assets"
version: "1.0.0"
provider: "Icons8"
tools: 4
---

# Icons8

Search and browse icons, illustrations, and design assets

## Icons8

Search and browse icons, illustrations, and design assets

### Available Tools (4)

- **search_icons**: 
Search for icons using the Icons8 API - the ONLY source for genuine Icons8 icons.
Use English terms and consider Icon8's metaphors for better results.

SEARCH TIPS - Use these general approaches for better matches:
• Use simple, descriptive terms (e.g., "home", "user", "settings")
• Try action words for functions (e.g., "search", "download", "edit")
• Use object names for items (e.g., "phone", "computer", "car")
• Consider synonyms if first search doesn't work
• Think about what the icon represents conceptually
• Use single words or short phrases for best results

Args:
    query: The search term to find icons (use metaphors above for better results)
    ctx: MCP context for API access
    platform: Optional filter by platform/style (e.g., 'ios', 'fluent', 'color')
    category: Optional filter by category (e.g., 'transport', 'business')
    amount: Maximum number of results to return (default: 10)
    offset: Number of results to skip (for pagination)

Returns:
    Search results including matching icons from Icons8 catalog
 — $0.01/call
- **list_categories**: 
List all available icon categories.

Args:
    ctx: MCP context for API access
    limit: Maximum number of results to return (default: 10)
    page: Page number for pagination (default: 1)

Returns:
    List of icon categories with subcategories
 — $0.01/call
- **list_platforms**: 
List all available icon platforms/styles.

Args:
    ctx: MCP context for API access
    limit: Maximum number of results to return (default: 100)
    page: Page number for pagination (default: 1)

Returns:
    List of icon platforms/styles
 — $0.01/call
- **get_icon_png_url**: 
Get a PNG URL for an icon by its ID - use when SVG is not available.
NOTE: SVG format is preferred for Icons8 icons when possible (use get_icon_svg).

Args:
    icon_id: The unique identifier of the icon
    ctx: MCP context for API access
    size: The preview image size in pixels (default: 24)

Returns:
    Dictionary containing the PNG preview URL
 — $0.01/call

### Quick Start

```json
{
  "mcpServers": {
    "icons8": {
      "url": "https://icons8.mcp.xpay.sh/mcp?key=YOUR_XPAY_KEY"
    }
  }
}
```

### Pricing

$0.01 per tool call. Pay per use from your XPay wallet. No subscriptions.

Get an API key at [xpay.tools](https://xpay.tools).


**Tools:** 4
**Category:** Media & Content

## When to Use

Use Icons8 tools when you need to search and browse icons, illustrations, and design assets. All tools are available through xpay✦'s single MCP connection.

## MCP Connection

```json
{
  "mcpServers": {
    "xpay": {
      "url": "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"
    }
  }
}
```

For Claude Code:
```bash
claude mcp add --transport http xpay "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"
```

## Available Tools

- **Search Icons** — 
Search for icons using the Icons8 API - the ONLY source for genuine Icons8 icons.
Use English terms and consider Icon8's metaphors for better results.

SEARCH TIPS - Use these general approaches for better matches:
• Use simple, descriptive terms (e.g., "home", "user", "settings")
• Try action words for functions (e.g., "search", "download", "edit")
• Use object names for items (e.g., "phone", "computer", "car")
• Consider synonyms if first search doesn't work
• Think about what the icon represents conceptually
• Use single words or short phrases for best results

Args:
    query: The search term to find icons (use metaphors above for better results)
    ctx: MCP context for API access
    platform: Optional filter by platform/style (e.g., 'ios', 'fluent', 'color')
    category: Optional filter by category (e.g., 'transport', 'business')
    amount: Maximum number of results to return (default: 10)
    offset: Number of results to skip (for pagination)

Returns:
    Search results including matching icons from Icons8 catalog
 — $0.01/call — [SKILL.md](https://xpay.tools/skills/icons8/search-icons/SKILL.md)
- **List Categories** — 
List all available icon categories.

Args:
    ctx: MCP context for API access
    limit: Maximum number of results to return (default: 10)
    page: Page number for pagination (default: 1)

Returns:
    List of icon categories with subcategories
 — $0.01/call — [SKILL.md](https://xpay.tools/skills/icons8/list-categories/SKILL.md)
- **List Platforms** — 
List all available icon platforms/styles.

Args:
    ctx: MCP context for API access
    limit: Maximum number of results to return (default: 100)
    page: Page number for pagination (default: 1)

Returns:
    List of icon platforms/styles
 — $0.01/call — [SKILL.md](https://xpay.tools/skills/icons8/list-platforms/SKILL.md)
- **Get Icon Png Url** — 
Get a PNG URL for an icon by its ID - use when SVG is not available.
NOTE: SVG format is preferred for Icons8 icons when possible (use get_icon_svg).

Args:
    icon_id: The unique identifier of the icon
    ctx: MCP context for API access
    size: The preview image size in pixels (default: 24)

Returns:
    Dictionary containing the PNG preview URL
 — $0.01/call — [SKILL.md](https://xpay.tools/skills/icons8/get-icon-png-url/SKILL.md)

## How to Execute

1. **`xpay_discover`** — Search for tools: `xpay_discover("icons8")`
2. **`xpay_details`** — Get input schema: `xpay_details("icons8/TOOL_NAME")`
3. **`xpay_run`** — Execute: `xpay_run("icons8/TOOL_NAME", { ...inputs })`
4. **`xpay_balance`** — Check credits

## Links

- Provider page: https://xpay.tools/icons8/
- All providers: https://xpay.tools/explore
- Docs: https://docs.xpay.sh