openai_ads_get_insights

Read ChatGPT Ads delivery, finalized cost and attributed conversions by account, campaign, ad group or ad.

Read ChatGPT Ads delivery, finalized cost and attributed conversions by account, campaign, ad group or ad. Inclusive local dates; native CTR/CVR are fractions; money uses major account currency units. Paginated automatically without retries; truncated output is explicit. Default attribution is 30-day click / 1-day view, ad-event time.

Source: ChatGPT Ads
Kind: Read
Discovery: Reachable through search_tools and run_tool
Account parameter: adAccountId
Endpoint: https://mcp.getmcpads.com/openai-ads/mcp

ParametersLink to this section

Name	Type	Required	Notes
`adAccountId`	string	Required	Exact verified and selected ChatGPT Ads account ID. The key is scoped to this account.
`since`	string	Required	Beginning of the requested reporting period; use the format accepted by the provider.
`until`	string	Required	End of the requested reporting period; use the format accepted by the provider.
`level`	string	Optional	Entity or aggregation level for the requested report. One of: `ad_account`, `campaign`, `ad_group`, `ad`. Default: `"campaign"`.
`metrics`	array	Optional	Native or documented calculated metric names to request. Check compatibility with the selected dimensions. Default: `["spend","impressions","clicks"]`.
`timeGranularity`	string	Optional	One of: `daily`, `none`. Default: `"daily"`.
`maxRows`	integer	Optional	Default: `10000`.

Calling itLink to this section

jsonThrough run_tool, since it is not announced

{
  "name": "run_tool",
  "arguments": {
    "name": "openai_ads_get_insights",
    "args": {
      "adAccountId": "<string>",
      "since": "<string>",
      "until": "<string>"
    }
  }
}