check_ai_visibility
Score how ready a local business is to be named when people ask AI engines (ChatGPT, Gemini, Google AI) for a recommendation in its category, and get a shareable Radveo report with the exact fixes to improve its odds. Scores readiness from the business's own site; it does not query an engine live. Honest answer-engine optimization: improves the odds of being cited, never guarantees a placement.
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": "check_ai_visibility"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| website | No | The business website URL, e.g. https://joesplumbing.com. Optional if business_name is given; improves accuracy. | |
| location | No | City or region, e.g. "Seattle, WA". Optional but improves accuracy. | |
| business_name | No | The business name, e.g. "Joe's Plumbing". Provide this OR a website. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | False when the check could not be completed (bad input, rate limit, or the audit engine timed out). | |
| note | Yes | Honesty framing: an indicative, measured read of how AI assistants tend to answer, never a guarantee of placement. | |
| verdict | Yes | Whether AI engines named this business when asked customer-style recommendation questions. 'named' = at least one query named it; 'absent' = confidently not named; 'unknown' = the engines could not give a confident read; 'not_checked' = the live AI-answer probe did not run for this call (the on-page audit still did). | |
| business | No | The business name or website that was checked. | |
| seoGrade | No | Letter grade (A-D) for the readiness score, when measured. | |
| seoScore | No | 0-100 on-page AI-visibility readiness score, when measured. | |
| topFixes | No | The top fixes to improve the odds of being named (max 3 here; full list in the report). | |
| reportUrl | Yes | Shareable, public report URL for this check. | |
| enginesChecked | No | The AI engine panel the probes consult: an indicative read of how AI assistants tend to answer, not a live probe of every public engine. | |
| queriesChecked | No | The customer-style questions asked to the AI engines (empty when the probe didn't run). | |
| competitorsNamed | No | Businesses surfaced instead of this one (deduped). Same list the public shareable report shows. | |
| aiVisibilityScore | No | 0-100: the share of customer-style AI queries that named the business. Null when the probe didn't produce a measured score. | |
| competitorsSource | No | 'ai' = an AI engine named them; 'places' = real local leaders from Google's local results (shown when the engines named none). Null when no competitors surfaced. |