# create_ai_scout (/docs/mcp/tools/create-ai-scout)

{/* 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/create_ai_scout.mdx. */}

**Create an AI Scout** · Changes data · Acts outside your account · Spends credits or money

Creates an AI Scout and runs it right away. Every day it reads its sources (Google, YouTube, review sites), finds the people behind them, scores how well they fit and adds those above the minimum fit as leads under Leads › AI Scout, 1 credit per lead, up to the people per day and the website's daily limit. Not on LTD plans.

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

## Parameters [#parameters]

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `websiteId` | `string` | Yes | Website ID from list_websites. |
| `name` | `string` | No | Optional. A short name; made from the description when left out. |
| `description` | `string` | Yes | Who to find, in a sentence or two: roles, industries, company size, where they talk (podcasts, YouTube, review sites). |
| `perDay` | `"10" \| "25" \| "50" \| "100"` | No | People per day to deliver: 10, 25, 50 or 100. |
| `minFit` | `number` | No | Minimum fit score (10-95, default 70): people below it are skipped. |
| `sources` | `object[]` | No | Optional. Where the scout reads: Google searches, YouTube searches, playlists or creators, G2 categories. Made from the description when left out; get them first with plan_ai_scout. |
| `sources[].kind` | `"google" \| "youtube_search" \| "youtube_playlist" \| "youtube_creators" \| "g2_category"` | Yes | google, youtube_search, youtube_playlist, youtube_creators or g2_category. |
| `sources[].ref` | `string` | Yes | The search words, the playlist or channel link, or the G2 category link. |
| `sources[].label` | `string` | No | Optional. How the source is shown in the dashboard. |
| `sources[].active` | `boolean` | No | false to keep the source but stop reading it. |

## Tool definition [#tool-definition]

What your assistant receives from `tools/list`:

```json
{
  "name": "create_ai_scout",
  "title": "Create an AI Scout",
  "annotations": {
    "title": "Create an AI Scout",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": true
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "websiteId": {
        "type": "string",
        "description": "Website ID from list_websites."
      },
      "name": {
        "type": "string",
        "description": "Optional. A short name; made from the description when left out."
      },
      "description": {
        "type": "string",
        "description": "Who to find, in a sentence or two: roles, industries, company size, where they talk (podcasts, YouTube, review sites)."
      },
      "perDay": {
        "type": "number",
        "enum": [
          10,
          25,
          50,
          100
        ],
        "description": "People per day to deliver: 10, 25, 50 or 100."
      },
      "minFit": {
        "type": "number",
        "minimum": 10,
        "maximum": 95,
        "description": "Minimum fit score (10-95, default 70): people below it are skipped."
      },
      "sources": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "enum": [
                "google",
                "youtube_search",
                "youtube_playlist",
                "youtube_creators",
                "g2_category"
              ],
              "description": "google, youtube_search, youtube_playlist, youtube_creators or g2_category."
            },
            "ref": {
              "type": "string",
              "description": "The search words, the playlist or channel link, or the G2 category link."
            },
            "label": {
              "type": "string",
              "description": "Optional. How the source is shown in the dashboard."
            },
            "active": {
              "type": "boolean",
              "description": "false to keep the source but stop reading it."
            }
          },
          "required": [
            "kind",
            "ref"
          ]
        },
        "description": "Optional. Where the scout reads: Google searches, YouTube searches, playlists or creators, G2 categories. Made from the description when left out; get them first with plan_ai_scout."
      }
    },
    "required": [
      "websiteId",
      "description"
    ]
  }
}
```