MCP server
update_ai_scout
Changes an AI Scout's name, description, people per day, minimum fit or sources.
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
| Parameter | Type | Required | Accepts | Description |
|---|---|---|---|---|
websiteId | string | Yes | any | Website ID from list_websites. |
scoutId | string | Yes | any | AI Scout ID from list_ai_scouts. |
name | string | No | any | A short name; made from the description when left out. |
description | string | No | any | Who to find, in a sentence or two: roles, industries, company size, where they talk (podcasts, YouTube, review sites). |
perDay | number | No | 10, 25, 50, 100 | People per day to deliver: 10, 25, 50 or 100. |
minFit | number | No | 10–95 | Minimum fit score (10-95, default 70): people below it are skipped. |
sources | object[] | No | any | 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 | string | Yes | google, youtube_search, youtube_playlist, youtube_creators, g2_category | google, youtube_search, youtube_playlist, youtube_creators or g2_category. |
sources[].ref | string | Yes | any | The search words, the playlist or channel link, or the G2 category link. |
sources[].label | string | No | any | Optional. How the source is shown in the dashboard. |
sources[].active | boolean | No | any | false to keep the source but stop reading it. |
Tool definition
What your assistant receives from tools/list:
{
"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"
]
}
}