Start AI visibility check
start_visibility_checkStarts an AI Visibility check of a site, the same as Run check on the AI Visibility page: Keytomic asks each available AI platform every Active prompt. The check uses one observation for each Active prompt on each platform. Without confirm, returns the plan and starts nothing (status plan): the observations the check needs, the observations left this month, availablePlatforms, and canStart with blockedReason. While the schedule runs the checks, a user can start only the first check of a site; the plan then says so (userStartAllowed false, canStart false and blockedReason manual_check_not_allowed) and gives nextRunAt, the next scheduled check. Show the plan to the user, and call again with confirm: true only after the user agrees. With confirm: true, starts the check and returns its checkId and the AI Visibility page link; read the result with get_visibility and get_visibility_report. When the check cannot start, the call with confirm: true gives a tool error and uses nothing, such as manual_check_not_allowed, insufficient_capacity or check_running. When AI Visibility is off in this deployment, the call gives feature_disabled.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"projectId": "<projectId>"
},
"name": "start_visibility_check"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| confirm | No | true starts the check. Send it only after the user saw the plan this tool returns without confirm and agreed. Without it, the tool returns the plan and starts nothing. | |
| projectId | Yes | Site to act on, from list_sites. |