---
name: "xpay-icons8-search-icons"
description: "
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
"
version: "1.0.0"
price: "$0.01/call"
provider: "Icons8"
---

# 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


**Provider:** Icons8
**Price:** $0.01/call
**Pricing model:** Flat rate per call

## When to Use

Use this tool when you need to 
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
. This is part of the Icons8 provider on xpay✦.

## MCP Connection

Connect to xpay✦ to access this tool (and 3+ others):

```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"
```

## How to Execute

Use the xpay✦ meta-tools to run this tool:

1. **`xpay_details`** — Get full input schema: `xpay_details("icons8/search_icons")`
2. **`xpay_run`** — Execute: `xpay_run("icons8/search_icons", { ...inputs })`

## Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `amount` | integer | No |  |
| `category` | string | No |  |
| `offset` | integer | No |  |
| `platform` | string | No |  |
| `query` | string | Yes |  |

## Pricing

- **Cost:** $0.01/call
- **Balance check:** Use `xpay_balance` to check remaining credits
- Get your API key at [xpay.tools](https://xpay.tools/account/settings/api-keys/) — $5 free credits included

## Related Skills

- [Icons8 (all tools)](https://xpay.tools/skills/icons8/SKILL.md) — 4 tools
- [List Categories](https://xpay.tools/skills/icons8/list-categories/SKILL.md) — $0.01/call
- [List Platforms](https://xpay.tools/skills/icons8/list-platforms/SKILL.md) — $0.01/call
- [Get Icon Png Url](https://xpay.tools/skills/icons8/get-icon-png-url/SKILL.md) — $0.01/call

## Links

- Tool page: https://xpay.tools/icons8/search-icons/
- Provider: https://xpay.tools/icons8/
- All tools: https://xpay.tools/explore