amazon ads get sb ads
amazon_ads_get_sb_adsRead one page of Sponsored Brands ads for a profile, with optional filters for ad, campaign, and delivery state; use nextToken to retrieve subsequent pages.
Instructions
Read one page of Sponsored Brands ads. 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_ads"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| adIds | No | Restrict results to these Sponsored Brands ad IDs, as decimal strings. | |
| 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. |