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.

View as Markdown Open in ChatGPT Open in Claude

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.

{
  "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

{
  "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

{
  "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

{
  "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:

{
  "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

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