MCP server
create_ai_scout
Creates an AI Scout and runs it right away.
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
| 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
What your assistant receives from tools/list:
{
"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"
]
}
}