# list_ai_scouts (/docs/mcp/tools/list-ai-scouts)

{/* Generated by scripts/sync-mcp-tools.mjs from happierleads-api. Do not edit: change src/routes/mcp/toolDocs.json there, or add content/mcp-notes/list_ai_scouts.mdx. */}

**List AI Scouts** · Read-only

Lists the AI Scouts of one website: name, description, status (running or paused), people per day, minimum fit, the sources it reads (readsFrom) and how many people each delivered, plus the website's daily AI Scout limit. Free. Use it to find a scoutId.

| Connection | Account URL, team member URL or OAuth |
| --- | --- |

## Parameters [#parameters]

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `websiteId` | `string` | Yes | Website ID from list_websites. |

## Tool definition [#tool-definition]

What your assistant receives from `tools/list`:

```json
{
  "name": "list_ai_scouts",
  "title": "List AI Scouts",
  "annotations": {
    "title": "List AI Scouts",
    "readOnlyHint": true,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "websiteId": {
        "type": "string",
        "description": "Website ID from list_websites."
      }
    },
    "required": [
      "websiteId"
    ]
  }
}
```