avenity_check_visibility
Check whether a business appears in AI-driven search results when buyers search for their primary service in their city.
This is the first-pass qualifier. If gap_confirmed=True, the business is NOT appearing when buyers search — meaning they are losing customers to competitors right now. This is the core hook for Avenity's service.
Use this when:
A business client asks why they're not getting found online
You need to confirm an AI visibility gap before recommending action
You want to frame the problem before showing a full report
Args: params (BusinessInput): Business details including name, service, city.
Returns: str: JSON with: gap_confirmed (bool): True = business is NOT visible for this query appears_in_ai_results (bool): Whether company name was detected query (str): The exact buyer search query analyzed competitors_appearing (list[str]): Who IS showing up instead result_count_checked (int): Number of results analyzed recommendation (str): Next suggested action for this business
Examples: - "Check if Apex HVAC shows up when people search for HVAC in Houston" - "Is my client visible in AI search?" → call with their company details - "Find out if [company] has an AI visibility gap"
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": {
"params": "<params>"
},
"name": "avenity_check_visibility"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |