MCPMCP Tools/AEO/get_aeo_rollup

get_aeo_rollup

Readlistings:read

AI-visibility roll-up across a client's (or the whole agency's) locations — the AEO 'all locations' table. Optional clientId scopes to one client; omit for agency-wide. Optional tags narrows to locations carrying ANY of the given internal tags (discover them with list_location_tags). Returns rows (per location: name, city, tags, overall AI-visibility score 0–100, per-engine ChatGPT/Gemini/Perplexity scores, latest report generatedAt + yearMonth; null score = no report generated yet) plus configuredEngines. Backs the AEO all-locations rollup.

Parameters
clientIdstringoptional
Scope to one client (from list_clients; omit for agency-wide)
tagsstring[]optional
Internal tags — narrow to locations carrying ANY of these (from list_location_tags). Each row also carries its location's tags.
Example request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_aeo_rollup",
    "arguments": {}
  }
}
Example response
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "..."
      }
    ]
  }
}

Response shape shown for illustration — the actual content depends on the tool and your data.