Suggest AI search questions
suggest_ai_search_questionsSuggest about 12 buyer questions and likely competitors from the company profile, homepage and latest website scan. One model call, about costs.suggestQuestionsAbout Energy, within today's daily limit. With confirmed=true it returns the suggested questions and competitors. Nothing is tracked until questions are added with add_ai_search_questions and competitors with update_ai_search_settings; the latest suggestions also appear in get_ai_search_overview settings. Without confirmed=true nothing runs and nothing is charged: it returns the Energy cost, the Energy left and today's AI search limit, with the call that runs it, or the money answer when Energy can't cover it. Tell the customer the cost, then call again with confirmed=true. If AI search is not on for this workspace yet, this turns it on (aiSearchTurnedOn in the result says what it starts with). Only for a connection created by a current owner or admin of this workspace.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "suggest_ai_search_questions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| confirmed | No | false prices the step and changes nothing; true runs it and spends Energy. Send true only after the customer agrees to the price. | |
| workspaceId | No | A teammate's workspace you may manage: an active workspace ID from list_team_workspaces. Omit for your own workspace. Supply on every call for a teammate. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| next | No | Preview only: the exact call that runs the step once the customer agrees; null when it can't run now. | |
| energy | Yes | What the step costs and the Energy left. | |
| message | No | A plain summary of the price or of what started, to pass on to the customer. | |
| started | No | false on the priced preview: nothing ran or was charged. | |
| questions | No | Run: suggested buyer questions; track them with add_ai_search_questions. | |
| readyToRun | No | Preview only: true when Energy and today's limit allow the step; then call next after the customer agrees. | |
| competitors | No | Run: likely competitors (name and domains); track them with update_ai_search_settings. | |
| aiSearchTurnedOn | No | Present only when this call turned AI search on: what it now runs with. Tell the customer. |