# update_ai_scout (/docs/mcp/tools/update-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/update_ai_scout.mdx. */}

**Update an AI Scout** · Changes data

Changes an AI Scout's name, description, people per day, minimum fit or sources. Only the fields you pass change.

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

## Parameters [#parameters]

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `websiteId` | `string` | Yes | Website ID from list_websites. |
| `scoutId` | `string` | Yes | AI Scout ID from list_ai_scouts. |
| `name` | `string` | No | A short name; made from the description when left out. |
| `description` | `string` | No | 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 | 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": "update_ai_scout",
  "title": "Update an AI Scout",
  "annotations": {
    "title": "Update an AI Scout",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "websiteId": {
        "type": "string",
        "description": "Website ID from list_websites."
      },
      "scoutId": {
        "type": "string",
        "description": "AI Scout ID from list_ai_scouts."
      },
      "name": {
        "type": "string",
        "description": "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": "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",
      "scoutId"
    ]
  }
}
```