`microsoft_ads_list_ad_extensions`

List Microsoft Ads Ad Extensions

Microsoft

Description

Read-onlyOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "microsoft_ads_list_ad_extensions",
    "arguments": {}
  }
}

hopkin microsoft ad-extensions list

Flag	Type	Required	Description
`--account`	`string`	Required	Microsoft Advertising account ID (AccountId).
`--customer-id`	`string`	Optional	Customer/manager ID (CustomerId). Required for agency-managed accounts.
`--campaign-ids`	`array`	Optional	Only these campaigns and their ad groups. Account-level extensions are still listed (they serve on every campaign) unless association_levels leaves Account out. Default: every campaign.
`--association-levels`	`array`	Optional	Which attachments to list: Account, Campaign, AdGroup. Default: all three — leave it out to see everything that serves on a campaign, since account-level extensions serve on every campaign and ad-group ones override the campaign's. Narrow it only when the user asks about one level.
`--extension-types`	`array`	Optional	Only these extension types, e.g. ["Sitelink", "Callout", "StructuredSnippet"]. Default: every type.
`--editorial-status`	`array`	Optional	Only associations in these editorial (policy) states: Disapproved (failed review, not serving), ActiveLimited (approved in some markets only), Inactive (under review), Active (approved). Applied to the whole scan before paging, so nothing is missed. Pass ["Disapproved", "ActiveLimited", "Inactive"] for "what is not approved". Default: every state.
`--include-raw`	`boolean`	Optional	Default false. When true, each row also carries the full extension as returned by Microsoft (every field, e.g. scheduling, device preference, all URLs). Much larger output.
`--limit`	`integer`	Optional	Rows per page (1-500, default 50).
`--cursor`	`string`	Optional	Opaque cursor from the previous response's nextCursor. Pass it with otherwise identical parameters to get the next page; a cursor reused with different filters is rejected. Omit for the first page.
`--connection-id`	`string`	Optional	Optional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.

{
  "mcpServers": {
    "microsoft-ads": {
      "url": "https://microsoft.mcp.hopkin.ai",
      "transport": "sse"
    }
  }
}

Parameters

Name	Type	Required	Description
`account_id`	`string`	Required	Microsoft Advertising account ID (AccountId).minLength: 1, maxLength: 20, pattern: ^\d+$
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (9)

Name	Type	Required	Description
`customer_id`	`string`	Optional	Customer/manager ID (CustomerId). Required for agency-managed accounts.minLength: 1, maxLength: 20, pattern: ^\d+$
`campaign_ids`	`array`	Optional	Only these campaigns and their ad groups. Account-level extensions are still listed (they serve on every campaign) unless association_levels leaves Account out. Default: every campaign.
`association_levels`	`array`	Optional	Which attachments to list: Account, Campaign, AdGroup. Default: all three — leave it out to see everything that serves on a campaign, since account-level extensions serve on every campaign and ad-group ones override the campaign's. Narrow it only when the user asks about one level.
`extension_types`	`array`	Optional	Only these extension types, e.g. ["Sitelink", "Callout", "StructuredSnippet"]. Default: every type.
`editorial_status`	`array`	Optional	Only associations in these editorial (policy) states: Disapproved (failed review, not serving), ActiveLimited (approved in some markets only), Inactive (under review), Active (approved). Applied to the whole scan before paging, so nothing is missed. Pass ["Disapproved", "ActiveLimited", "Inactive"] for "what is not approved". Default: every state.
`include_raw`	`boolean`	Optional	Default false. When true, each row also carries the full extension as returned by Microsoft (every field, e.g. scheduling, device preference, all URLs). Much larger output.
`limit`	`integer`	Optional	Rows per page (1-500, default 50).min: 1, max: 500
`cursor`	`string`	Optional	Opaque cursor from the previous response's nextCursor. Pass it with otherwise identical parameters to get the next page; a cursor reused with different filters is rejected. Omit for the first page.minLength: 1
`connection_id`	`string`	Optional	Optional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.