amazon ads get sb ad groups
amazon_ads_get_sb_ad_groupsRetrieve Sponsored Brands ad group data for a specified account ID. Filter results by delivery state or campaign IDs to view specific ad group details.
Instructions
Read one page of Sponsored Brands ad groups. Requires Brands eligibility in this profile. Includes all states by default; follow nextToken. Configuration is not performance.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"accountId": "<accountId>"
},
"name": "amazon_ads_get_sb_ad_groups"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| states | No | Delivery states to include. Defaults to every state, archived included. | |
| accountId | Yes | Advertising profile ID listed in AMAZON_ADS_PROFILE_IDS, such as 1234567890. The region-qualified form used by hosted getmcpads, such as EU:1234567890, is accepted when its region matches AMAZON_ADS_REGION. | |
| nextToken | No | Opaque continuation token from the previous page for this same profile and filters. Omit on the first request. | |
| maxResults | No | Maximum entities in this page, up to 100. Follow the returned continuation value for the rest. | |
| campaignIds | No | Restrict results to these campaign IDs, as decimal strings. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes | Original tool result: parsed JSON when the text is JSON, otherwise the text or multiple MCP content blocks. Provider fields depend on the selected query. |