# Example responses

> Real example responses from GetIntel's MCP tools, shortened and with brand names replaced, so you can see the shape of the data your agent receives.

Source: https://getintel.ai/docs/mcp/example-responses/

Each tool returns JSON. These examples come from real responses, shortened to one or two items per list, with brand names and URLs replaced.

## get_overview

The Home page for a period: visibility against rivals, topics, perception, pages, AI traffic, technical and actions.

```json
{
  "period": { "from": "2026-09-11", "to": "2026-09-17", "days": 7 },
  "you": { "name": "YourBrand" },
  "visibility": {
    "brands": [
      { "key": "you", "name": "YourBrand", "domain": "yourbrand.com", "you": true,
        "vis": 5.4, "sov": 1, "cit": 5.3, "pos": 5.1, "latest_vis": 5.4 },
      { "key": "acme", "name": "Acme", "domain": "acme.com",
        "vis": 50.6, "sov": 9.8, "cit": 13.5, "pos": 2.8, "latest_vis": 50.6 }
    ],
    "series": [
      { "d": "2026-09-11",
        "vis": { "you": 5.4, "acme": 50.6 },
        "sov": { "you": 1, "acme": 9.8 },
        "cit": { "you": 5.3, "acme": 13.5 },
        "pos": { "you": 5.1, "acme": 2.8 } }
    ],
    "answers": 207, "mentions": 1074, "citations": 148
  },
  "topics": [
    { "id": 31, "name": "AI citation gaps", "you": 0, "prev": 6.7, "leader": "Beta", "leader_share": 38.9 }
  ],
  "perception": null,
  "pages": {
    "cited": 6, "prev": 0, "new": 6,
    "top": [ { "path": "/solutions/agencies", "title": "AI Visibility for Agencies", "url": "https://yourbrand.com/solutions/agencies/", "n": 4 } ],
    "losing": null
  },
  "crawlers": { "connected": false },
  "visitors": { "connected": false },
  "technical": { "score": 100, "scanned_at": "2026-09-12T18:44:54+05:30",
    "engines": [ { "key": "chatgpt", "score": 100, "ok": true } ] },
  "actions": [ { "layer": "on_page", "open": 19, "next": "Improve your “YourBrand vs Acme” page" } ]
}
```

`vis`, `sov` and `cit` are percentages; `pos` is average position (lower is better). `perception` is `null` on plans without brand perception.

## get_topics

```json
{
  "period": { "from": "2026-09-11", "to": "2026-09-17", "days": 7 },
  "topics": [
    {
      "id": 31, "name": "AI citation gaps", "category": "pain_point", "priority": 1,
      "visibility": 0, "previous": 6.7, "change": -6.7, "rank": 7,
      "top_rival": "Beta", "top_rival_share": 38.9,
      "top_rivals": [
        { "name": "Beta", "rate": 0.3889, "sov": 0.4706, "position": 1.14 },
        { "name": "Gamma", "rate": 0.1806, "sov": 0.2353, "position": 1.5 }
      ],
      "answers": 20, "as_of": "2026-09-11"
    }
  ]
}
```

`visibility` is null for a topic not scored yet. In `top_rivals`, `rate` and `sov` are fractions from 0 to 1.

## get_ai_answers

```json
{
  "run_date": "2026-09-11 00:20:14 +0530",
  "as_of": "2026-09-11",
  "window_days": 7,
  "named_count": 10,
  "total_count": 57,
  "questions": [
    {
      "probe_id": 1797,
      "prompt": "Which tool shows why ChatGPT recommends my competitors instead of me?",
      "mentioned_us": false,
      "rate": 0,
      "runs_counted": 1,
      "engines": { "openai": "absent", "perplexity": "absent", "gemini_direct": "absent", "google_aio": "error" }
    }
  ]
}
```

Engine keys: `openai` (ChatGPT), `perplexity`, `gemini_direct` (Gemini), `google_aio` (Google AI Overviews). Per engine, the state is `recommended`, `mentioned`, `absent`, `open`, `no_answer` or `error` (the run failed).

## list_tasks

```json
{
  "open_by_layer": { "on_page": 20, "off_page": 26, "ugc": 26, "technical": 3 },
  "tasks": [
    {
      "id": 211, "key": "connect:gsc", "layer": "technical", "kind": "connect",
      "title": "Connect Google Search Console", "status": "open",
      "score": 26.769, "effort_min": 5, "confirmed": true, "days_seen": 1,
      "planned": false, "week_of": null, "snoozed": false, "snoozed_until": null,
      "topics": [], "first_seen_at": "2026-09-12T18:35:00+05:30",
      "done_at": null, "resolved_at": null
    }
  ]
}
```

## get_task

The same fields as a `list_tasks` row, plus `data`, the brief:

```json
{
  "id": 211,
  "title": "Connect Google Search Console",
  "layer": "technical",
  "status": "open",
  "effort_min": 5,
  "data": {
    "why": "Google’s AI Overviews and AI Mode only use pages Google has indexed. Connecting Search Console shows which of your key pages are in — and Google’s reason when one isn’t.",
    "reach": 20,
    "fit": 5.0,
    "confidence": "proven",
    "integration": "Search Console"
  }
}
```

`data` varies by task kind: content tasks carry the facts to cover, off-page tasks the source to get onto.

## get_usage

```json
{
  "period": "month",
  "resets_on": "2026-10-01",
  "reads": { "used": 8, "limit": 50000, "remaining": 49992 },
  "drafts": { "used": 0, "limit": 999, "remaining": 999 }
}
```