# tiktok_live-search_ranked_anchors

`MCP Tool`

Find TikTok LIVE creators in the rankings data by @handle or nickname (at least 3 characters). Returns each match's numeric user ID, which the leaderboard tools take. limit defaults to 1 and caps at 10.

## MCP Server

This tool is available via the Euler Stream MCP server. Connect using any MCP-compatible client.

**Endpoint:** `https://tiktok.eulerstream.com/mcp?apiKey=YOUR_API_KEY`

**Configuration (mcp-remote):**
```json
{
  "mcpServers": {
    "euler-stream": {
      "command": "npx",
      "args": ["mcp-remote", "https://tiktok.eulerstream.com/mcp?apiKey=YOUR_API_KEY"]
    }
  }
}
```

**Direct URL (Cursor, etc.):**
```json
{
  "mcpServers": {
    "euler-stream": {
      "url": "https://tiktok.eulerstream.com/mcp?apiKey=YOUR_API_KEY"
    }
  }
}
```


## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | Yes | The username or nickname substring to search for (minimum 3 characters). |
| `limit` | number | No | Maximum number of results to return (default 1, max 10). |