# Leads

> Leads found by the account's Signals agents, hottest first, with why each one fits.

`leads.list` · read

- **MCP tool:** `get_leads`. Loaded by default in MCP clients.
- **REST:** `GET /v1/leads/list`
- **CLI:** `xholic leads list`
- **Scope:** `read`
- **Plan:** Pro plan or higher
- **Cost:** Free.
- **Rate limit bucket:** `read`

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `agentId` | string (uuid) | No |  |
| `status` | "ALL" \\| "COLLECTED" \\| "CONTACTED" \\| "DISMISSED" | No | Default: `"ALL"`. |
| `limit` | integer 1–20 | No | Default: `10`. |
| `account` | string ≤ 64 chars | No | X account to act on, as @handle. Leave it out to use the connection's default account. |