---
name: "visibility_setup"
area: "visibility"
title: "Set up AI visibility tracking"
price: "$0.001"
method: "POST"
url: "https://api.conecto.chat/v1/tools/visibility_setup"
mcp_server: "https://api.conecto.chat/mcp/visibility"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/visibility/visibility_setup"
---

# Set up AI visibility tracking (`visibility_setup`)

Chooses what to track for a website: the buyer questions, the competitors and the assistants to ask.

Choose what to track for a website: the buyer questions to ask the assistants (up to 10), the competitors to compare against (up to 10, each with its domains), and which assistants to check (default: all of ChatGPT, Claude, Gemini, Grok, Perplexity, DeepSeek, AI Overviews). Send only what you want to change. Without questions, the first check writes five from the website.

Price: $0.001 a call. A call that fails costs nothing.

## Use it when

Before the first check, or when the questions or competitors change.

## Say this to your agent

> Track how AI assistants talk about us when people ask about bike repair in Portland, and compare us with REI and Trek.

## Inputs

| Name | Type | Required | Description | Allowed values | Default |
|---|---|---|---|---|---|
| `website` | string | yes | The business website, e.g. https://acme.com (4 to 500 characters) |  |  |
| `brand_name` | string | no | Up to 80 characters. |  |  |
| `questions` | array of objects | no | Up to 10 items. |  |  |
| `questions[].question` | string | yes, in each item of `questions` | 3 to 300 characters. |  |  |
| `questions[].country` | string | no | Matches ^[A-Za-z]{2}$. |  |  |
| `questions[].topic` | string | no | Up to 60 characters. |  |  |
| `competitors` | array of objects | no | Up to 10 items. |  |  |
| `competitors[].name` | string | yes, in each item of `competitors` | 1 to 80 characters. |  |  |
| `competitors[].domains` | array of strings | no | Up to 5 items. |  |  |
| `assistants` | array of strings | no | At least 1 item. | `"ChatGPT"`, `"Claude"`, `"Gemini"`, `"Grok"`, `"Perplexity"`, `"DeepSeek"`, `"AI Overviews"` |  |

## Example

Written for Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon.

MCP: call `visibility_setup` on the MCP server `https://api.conecto.chat/mcp/visibility` with these arguments:

```json
{
  "website": "https://halversoncycle.example",
  "brand_name": "Halverson Cycle & Repair",
  "questions": [
    {
      "question": "Where can I get my bike repaired in Portland?",
      "country": "US"
    },
    {
      "question": "Best bike shop in Portland for a gravel bike",
      "country": "US"
    }
  ],
  "competitors": [
    {
      "name": "REI",
      "domains": [
        "rei.com"
      ]
    },
    {
      "name": "Trek",
      "domains": [
        "trekbikes.com"
      ]
    }
  ]
}
```

REST:

```bash
curl https://api.conecto.chat/v1/tools/visibility_setup \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"website": "https://halversoncycle.example", "brand_name": "Halverson Cycle & Repair", "questions": [{"question": "Where can I get my bike repaired in Portland?", "country": "US"}, {"question": "Best bike shop in Portland for a gravel bike", "country": "US"}], "competitors": [{"name": "REI", "domains": ["rei.com"]}, {"name": "Trek", "domains": ["trekbikes.com"]}]}'
```

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "visibility_setup",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.001",
  "balance_usd": "$19.75",
  "result": {
    "website": "https://halversoncycle.example",
    "brand": "Halverson Cycle & Repair",
    "questions": [
      "Where can I get my bike repaired in Portland?",
      "Best bike shop in Portland for a gravel bike"
    ],
    "competitors": [
      "REI",
      "Trek"
    ],
    "assistants": [
      "ChatGPT",
      "Claude"
    ],
    "check_price_usd": "$0.56"
  }
}
```

`result`: The website, brand, active questions, competitors and assistants, and check_price_usd: what one check costs with these assistants.

## Errors

| Code | Status | When | Fix |
|---|---|---|---|
| `invalid_input` | 400 | No business website was given. | Send it like https://halversoncycle.example. |
| `invalid_input` | 400 | Too many questions or competitors, a question without words, or no assistant chosen. | Send up to 10 questions and 10 competitors, and at least one assistant. |

The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md

## Related

- [visibility_check](https://conecto.chat/tools/visibility/visibility_check.md): Asks every tracked question on each chosen assistant, with web search on, and measures how often and how well the business is named. $0.04 per answer (one question on one assistant).
- [visibility_report](https://conecto.chat/tools/visibility/visibility_report.md): The latest check: how often the business is named, its trend, each assistant, its rank against the competitors, the sites cited, and the next actions. Free up to 1,000,000 reads a month.
- [visibility_answers](https://conecto.chat/tools/visibility/visibility_answers.md): The answers behind the latest check, page by page, optionally only the ones that named the business or only the ones that did not. Free up to 1,000,000 reads a month.
- [visibility_improve](https://conecto.chat/tools/visibility/visibility_improve.md): What to do to be named more often: the actions from the latest check, highest impact first, with concrete steps. Free up to 1,000,000 reads a month.