Skip to content
Get MCP AdsGet MCP Ads, home

openai_ads_get_ads

List one page of ads and native creative metadata for a ChatGPT Ads ad group. One of 55 ChatGPT Ads tools on the Get MCP Ads MCP gateway.

List one page of ads and native creative metadata for a ChatGPT Ads ad group. Preserve the provider's review status and pagination.

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.
adGroupIdstringRequiredExact ad group 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_ads",
    "args": {
      "adAccountId": "<string>",
      "adGroupId": "<string>"
    }
  }
}
Esc

Type to search