Get ad group insights

Loading server catalog…. Download catalog

POSThttps://app.advarde.com/mcp

Read

Upstream account eligibility and feature access may also apply.

Description: Get ad group insights aggregated by time granularity. Attribution metrics for the current account-local day are preliminary and may change as conversions are processed.

Method: tools/call · ads_get_ad_group_insights

Output: Tool data is returned in result.structuredContent and as JSON text in result.content. Inspect result.isError before using the result. Individual output fields depend on the operation.

Access: Read access to the relevant workspace and account.

Upstream operation: GET /ad_groups/{ad_group_id}/insights. Call this through the MCP tool above.

Authentication

Use an MCP access token from MCP connections, or connect through OAuth. Send your token in the Authorization: Bearer header.

For full protocol initialization and tool discovery, use an MCP client. These examples show individual JSON-RPC requests.

Tool arguments

Send these fields inside params.arguments. The tool name is sent as params.name.

account_idstringrequired

Workspace-owned Advarde connection ID from ads_list_accounts.

format: "uuid"

ad_group_idstringrequired

time_granularitystringoptional

aggregation_levelstringoptional

limitintegeroptional

minimum: 1maximum: 2000

beforestringoptional

afterstringoptional

time_rangesarrayoptional

EXPAND TIME_RANGES

Each array item

{
  "type": "string"
}

filtersarrayoptional

EXPAND FILTERS

Each array item

{
  "type": "string"
}

fieldsarrayoptional

EXPAND FIELDS

Each array item

{
  "type": "string"
}

sortarrayoptional

EXPAND SORT

Each array item

{
  "type": "string"
}

segmentsarrayoptional

EXPAND SEGMENTS

Each array item

{
  "type": "string"
}

override_segment_group_orderarrayoptional

EXPAND OVERRIDE_SEGMENT_GROUP_ORDER

Each array item

{
  "type": "string"
}

includesarrayoptional

EXPAND INCLUDES

Each array item

{
  "type": "string"
}

Full JSON Schema

{
  "type": "object",
  "properties": {
    "account_id": {
      "type": "string",
      "format": "uuid",
      "description": "Workspace-owned Advarde connection ID from ads_list_accounts."
    },
    "ad_group_id": {
      "type": "string"
    },
    "time_granularity": {
      "type": "string"
    },
    "aggregation_level": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 2000
    },
    "before": {
      "type": "string"
    },
    "after": {
      "type": "string"
    },
    "time_ranges": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "filters": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "sort": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "segments": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "override_segment_group_order": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "includes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "account_id",
    "ad_group_id"
  ],
  "additionalProperties": false
}

Responses

200Successful protocol response

Inspect result.isError for tool-level failures, even when the HTTP status is 200.

202Notification accepted

MCP notifications return no JSON-RPC response body.

400Invalid request

Check the JSON-RPC envelope, parameters, and protocol version.

406Not acceptable

Accept must include application/json and text/event-stream.

429Rate limited

Wait for the Retry-After interval before making another request.

401Unauthorized

A valid, unexpired MCP bearer token is required.

403Access denied

Your connection needs access to this workspace and the requested operation.