Amazon Ads
Sponsored Products Ad Group List MCP
List ad groups and their settings to review how products and targeting are organized within your advertising campaigns.
Sponsored Products Ad Group 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 Products Ad Group
Prompt: List sponsored products ad group for 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 Products Ad Group
Prompt: Review up to 20 sponsored products ad group records for my connected Amazon Ads account [connection ID]. Read one page only, leave automatic page collection off, and tell me whether additional results remain.
3. Find Sponsored Products Ad Group By Ad Group ID
Prompt: For my connected Amazon Ads account [connection ID], show sponsored products ad group matching ad groups [ad group IDs]. Keep the chosen filter with the returned records and stop after the first page.
4. Find Sponsored Products Ad Group By Campaign ID
Prompt: For my connected Amazon Ads account [connection ID], show sponsored products ad group matching campaigns [campaign IDs]. Keep the chosen filter with the returned records and stop after the first page.
5. Find Sponsored Products Ad Group By Campaign Targeting Type
Prompt: For my connected Amazon Ads account [connection ID], show sponsored products ad group matching [campaign targeting type]. Keep the chosen filter with the returned records and stop after the first page.
6. Find Sponsored Products Ad Group By Name
Prompt: For my connected Amazon Ads account [connection ID], show sponsored products ad group matching [entity name]. Keep the chosen filter with the returned records and stop after the first page.
7. Find Sponsored Products Ad Group By State
Prompt: For my connected Amazon Ads account [connection ID], show sponsored products ad group matching [enabled, paused or archived status]. Keep the chosen filter with the returned records and stop after the first page.
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_sp_ad_groups_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-sp-ad-groups-list-1",
"method": "tools/call",
"params": {
"name": "nexscope_data_amazon_ads_developer_proxy_sp_ad_groups_list",
"arguments": {
"body": "{}",
"contentType": "application/vnd.spAdGroup.v3+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.spAdGroup.v3+json。 |
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). |
adGroups | array | optional | Ad group 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
Show one page of sponsored products ad group for my connected Ads account.
Illustrative Response Explanation
The illustrative response returns no sponsored products ad group records on this page. It does not prove that the account has no matching records outside the requested scope, and no settings were changed.
About this sample: Illustrative fictional data, not a live tool call. This is one bounded page. A zero returned count must not be presented as a market-wide or unfiltered-account total.
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-sp-ad-groups-list-example",
"method": "tools/call",
"params": {
"name": "nexscope_data_amazon_ads_developer_proxy_sp_ad_groups_list",
"arguments": {
"connectionId": 123,
"method": "POST",
"contentType": "application/vnd.spAdGroup.v3+json",
"body": "{}",
"fetchAll": false,
"maxResults": 20
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "data-amazon-ads-developer-proxy-sp-ad-groups-list-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"success\":true,\"adGroups\":[],\"total\":0,\"pagesFetched\":1,\"truncated\":false}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"success": true,
"adGroups": [],
"total": 0,
"pagesFetched": 1,
"truncated": false
}
},
"isError": false
}
}