List keyword groups

curl "https://herculeradar.com/api/v1/keyword-groups" \
  --header "Authorization: Bearer hr_live_…"

Tool name list_keyword_groups. It takes the same input and returns the same { data, meta } envelope as REST, because both call the same function.

Own-brand vs competitor piles. Used for share of voice.

{
  "data": {
    "groups": [
      {
        "id": "uuid",
        "name": "My brand",
        "is_own": true
      }
    ]
  },
  "meta": {
    "capability": "list_keyword_groups",
    "requestId": "req_9f2b4a8c1d0e",
    "idempotencyReplayed": false,
    "docs": "https://herculeradar.com/docs/reference/list_keyword_groups"
  }
}

Requires the monitors:read scope. A credential without it gets 403 FORBIDDEN. Resources in projects the credential cannot reach answer 404 NOT_FOUND rather than 403, so ids cannot be probed across tenants.