get_overview - Kept AI Docs

Read overview KPIs, trends and top brands.

Arguments#

Name	Type	Required	Values and constraints
`host`	string	Required	maxLength 253 Project host from list_projects, without scheme or path.
`days`	integer	Optional	`7`, `30`, `90` Inclusive calendar days; defaults to 30.
`engine`	string	Optional	`chat_gpt`, `chat_gpt_web`, `gemini_web`, `google_ai_mode`, `google_ai_overview`, `perplexity_web`, `copilot_web`, `grok_web`, `perplexity`, `gemini`, `claude`

Additional properties are rejected.

Example call#

Send this JSON-RPC body to POST https://app.keptai.com/mcp after the client’s initialize handshake, with your Bearer header.

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "get_overview",
    "arguments": {
      "host": "example.com"
    }
  }
}

Result and limits#

Reads overview KPIs, trends, and top brands in the chosen scope.

Results contain text JSON and structuredContent. Check isError on tool failures and _meta.truncated for clipped data. All tools are read-only and respect project access. See Setup for authentication and rate limits.