Amazon Ads
Sponsored Brands Ad Creative List MCP
List creative assets for a Sponsored Brands ad so you can review the content used in that advertisement. Available through Nexscope REST and MCP.
Sponsored Brands Ad Creative List AI Prompts & Use Cases
After connecting this MCP tool to your AI assistant, you can ask the questions below. Replace bracketed placeholders with your own inputs and use the supported values in Arguments.
New to Nexscope MCP? Follow the connection guide, then use the prompts below. The Integration and Parameters & Response tabs contain the connection steps, call example, and technical reference.
1. Review Sponsored Brands Ad Creative
Prompt: List sponsored brands ad creative for ad [ad ID] in my connected Amazon Ads account [connection ID]. Show only the returned records and state whether more results remain; do not change any settings. Read one page of up to 20 records and stop; leave automatic page collection off.
2. Review A Limited Set Of Sponsored Brands Ad Creative
Prompt: Review up to 20 sponsored brands ad creative records for ad [ad ID] in my connected Amazon Ads account [connection ID]. Read one page only, leave automatic page collection off, and tell me whether additional results remain.
3. Review Creative Versions For One Ad
Prompt: For my connected Amazon Ads account [connection ID], show creative versions belonging to ad [ad ID]. Keep the result scoped to that ad rather than treating it as a full-account creative inventory. Read one page of up to 20 records and stop; leave automatic page collection off.
What You Need to Provide
Use an Amazon Ads connection you own. Never put provider credentials into a prompt or request body.
Changes require a preview followed by separate approval of the exact change. A successful example is not permission to modify an account.
Some legacy fields and operation details are incompletely documented. The examples cover the confirmed workflows; check the stated response and input limitations before using this route.
Step 1 · Connect
Connect Your AI Assistant
Connect a compatible MCP client to Nexscope, then select this tool from your assistant. Use the connection settings in your client to complete authentication.
POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/jsonAuthentication
Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxUsing an API key? Get your key from API Access and include it in the Authorization header shown above.
Call this MCP tool
nexscope_data_amazon_ads_developer_proxy_sb_ads_creatives_listhttps://api.nexscope.ai/mcptools/callInitialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.
{
"jsonrpc": "2.0",
"id": "data-amazon-ads-developer-proxy-sb-ads-creatives-list-1",
"method": "tools/call",
"params": {
"name": "nexscope_data_amazon_ads_developer_proxy_sb_ads_creatives_list",
"arguments": {
"accept": "application/vnd.sbAdCreativeResource.v4+json",
"body": "{\"adId\":\"998877\"}",
"contentType": "application/vnd.sbAdCreativeResource.v4+json",
"method": "POST"
}
}
}MCP 2025-11-25 · Streamable HTTPProgress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.
Arguments
| Name | Type | Required | Description |
|---|---|---|---|
connectionId | integer | required | An Amazon Ads connection owned by the authenticated Nexscope user. |
fetchAll | boolean | optional | Automatic page turning; SP and SB V4 main resource lists use `nextToken`, SB Target/BudgetRule uses `nextToken` (BudgetRule query must contain `pageSize`), SB Keyword GET, SB V3 GET and SD use `startIndex + count`. Example: true |
maxResults | integer | optional | Single page 1–100; SD corresponds to count. Example: 100 |
skipDepCheck | boolean | optional | Skip dependency checking. Example: false |
includeExtendedDataFields | boolean | optional | Some entities return extended fields; SD is switched through the /extended path. |
locale | string | optional | Localization parameters (supported by some keyword scripts). |
method | string | required | Upstream HTTP method; list query is `POST`. |
body | string | optional | The filter and Amazon native request body are placed in the body string; the paging method is subject to the `fetchAll` description of the corresponding interface. |
contentType | string | optional | application/vnd.sbAdCreativeResource.v4+json。 |
accept | string | optional | `application/vnd.sbAdCreativeResource.v4+json`。 |
adId | string/number | required | To query the Ad ID of Creative Version; not the full account Creative list. |
queryString | string | optional | Pass upstream query parameters when needed. |
confirmationToken | string | optional | For mutations, first preview without a token, then confirm using the returned single-use token. |
Response fields
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
success | boolean | optional | Whether the API completed the call successfully. |
apiVersion | string | optional | `V3` or `V4` (if provided by the script). |
amazonResourceVersion | string | optional | The actual Amazon resource version (if provided by the script). |
creatives | array | optional | Sponsored Brands Creative Version query array; actual fields returned by Amazon. |
total | integer | optional | The number of aggregated entries (if provided by the script). |
pagesFetched | integer | optional | Number of pages obtained. |
truncated | boolean | optional | Whether it was truncated due to paging limit. |
name | string | optional | Name (returned if supported by the entity). |
state | string | optional | `ENABLED`, `PAUSED` or `ARCHIVED` (SD upstream may use lowercase). |
Format Illustration
Illustrative example with fictional data, not a live tool call.
Illustrative Question
List sponsored brands ad creative for my connected Ads account and ad 998877.
Illustrative Response Explanation
The illustrative query returns an empty page. There are no returned records to summarize; this does not establish that no matching entities exist outside the requested account and filter scope.
About this sample: Fictional empty-result example, not a live account query. Required native filter details remain subject to the legacy endpoint documentation.
Published sample data is not available for this page. A format illustration or workflow guide is not a substitute for a published result.
View the MCP Request & Response Format
Examples
Illustrative example with fictional data, not a live tool call.
The JSON-RPC envelope below illustrates how the shown arguments and payload fit into MCP. It is not captured network traffic or proof of a successful call. Workflow-only examples do not include a result.
MCP Request
{
"jsonrpc": "2.0",
"id": "data-amazon-ads-developer-proxy-sb-ads-creatives-list-example",
"method": "tools/call",
"params": {
"name": "nexscope_data_amazon_ads_developer_proxy_sb_ads_creatives_list",
"arguments": {
"accept": "application/vnd.sbAdCreativeResource.v4+json",
"body": "{\"adId\":\"998877\"}",
"contentType": "application/vnd.sbAdCreativeResource.v4+json",
"method": "POST",
"connectionId": 123,
"fetchAll": false,
"maxResults": 20,
"adId": "998877"
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "data-amazon-ads-developer-proxy-sb-ads-creatives-list-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"success\":true,\"creatives\":[],\"total\":0,\"pagesFetched\":1,\"truncated\":false}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"success": true,
"creatives": [],
"total": 0,
"pagesFetched": 1,
"truncated": false
}
},
"isError": false
}
}