Skip to content
Get MCP AdsGet MCP Ads, home

openai_ads_get_ad_groups

List one page of ChatGPT Ads ad groups for a campaign. One of 55 ChatGPT Ads tools on the Get MCP Ads MCP gateway.

List one page of ChatGPT Ads ad groups for a campaign. Native ad group IDs are adgrp_ identifiers; preserve has_more and last_id.

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

NameTypeRequiredNotes
adAccountIdstringRequiredExact verified and selected ChatGPT Ads account ID. The key is scoped to this account.
campaignIdstringRequiredExact campaign ID in the selected advertising account.
limitintegerOptionalMaximum number of returned items or rows. The declared bounds and default apply; use pagination for additional results. Default: 100.
afterstringOptionalNext-page cursor: the previous page's last_id, only when has_more is true.
beforestringOptionalOpaque cursor for the previous page returned by Meta.
namestringOptionalHuman-readable name for this object.
includearrayOptionalRequest native reasons why this entity cannot serve. Paused state is intentional during acceptance.
orderstringOptionalOne of: asc, desc. Default: "desc".

Calling itLink to this section

jsonThrough run_tool, since it is not announced
{
  "name": "run_tool",
  "arguments": {
    "name": "openai_ads_get_ad_groups",
    "args": {
      "adAccountId": "<string>",
      "campaignId": "<string>"
    }
  }
}
Esc

Type to search