Check AI search now
run_ai_search_checkAsk the chosen engines every tracked question now, or only questionIds. Each answer costs Energy (about costs.checkOneQuestionAbout per question) and the check stays within today's daily limit: questions that would pass it are skipped and counted in skippedForDailyLimit. With confirmed=true it returns the answers queued, skippedForDailyLimit and the Energy it charges. The first check also starts the weekly or daily schedule. Answers usually arrive within a few minutes; read them with get_ai_search_overview or get_ai_search_question. 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": "run_ai_search_check"
}
}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. | |
| questionIds | No | Tracked questions to check, from get_ai_search_overview or add_ai_search_questions. Omit to check every tracked question. | |
| 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. | |
| queued | No | Run: answers being asked now. | |
| answers | No | Preview: answers the check asks for. | |
| engines | No | Preview: the engines it asks. | |
| message | No | A plain summary of the price or of what started, to pass on to the customer. | |
| samples | No | Preview: times each engine is asked each question. | |
| started | No | false on the priced preview: nothing ran or was charged. | |
| frequency | No | Run: how often checks now repeat. | |
| questions | No | Preview: how many questions the check asks. | |
| readyToRun | No | Preview only: true when Energy and today's limit allow the step; then call next after the customer agrees. | |
| nextCheckAt | No | Run: when the next automatic check runs. | |
| whyUnavailable | No | Preview: why those engines are left out. | |
| aiSearchTurnedOn | No | Present only when this call turned AI search on: what it now runs with. Tell the customer. | |
| enginesUnavailable | No | Preview: chosen engines left out for now. | |
| skippedForDailyLimit | No | Run: answers skipped because they would pass today's limit. |