Amazon Advertising
Amazon Ads SP Audience Report MCP
Create an Amazon Sponsored Products audience report for your chosen dates. View results by account, campaign, or ad group.
Amazon Ads SP Audience Report 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. Get Daily Audience Data
Prompt: Create one daily Sponsored Products audience report for my Amazon Ads connection [CONNECTION_ID] from [START_DATE] through [END_DATE]. Use an end date no later than today and no earlier than the start date. Return its report reference and status, then use that reference for follow-up checks.
2. Get Summary Audience Data
Prompt: Create one summary Sponsored Products audience report for my Amazon Ads connection [CONNECTION_ID] from [START_DATE] through [END_DATE]. Use an end date no later than today and no earlier than the start date. Return its report reference and status, then use that reference for follow-up checks.
3. Check Audience By Account
Prompt: Create one Sponsored Products audience report at account level for my connection [CONNECTION_ID] from [START_DATE] through [END_DATE], using daily totals and valid inclusive dates ending no later than today.
4. Check Audience By Campaign
Prompt: Create one Sponsored Products audience report at campaign level for my connection [CONNECTION_ID] from [START_DATE] through [END_DATE], using daily totals and valid inclusive dates ending no later than today.
5. Check Audience By Ad Group
Prompt: Create one Sponsored Products audience report at ad group level for my connection [CONNECTION_ID] from [START_DATE] through [END_DATE], using daily totals and valid inclusive dates ending no later than today.
6. Use A Specific Advertiser Account
Prompt: Create one Sponsored Products audience report for [CONNECTION_ID] and recovery advertiser account [ADVERTISER_ACCOUNT_ID], from [START_DATE] through [END_DATE], ending no later than today. Use this explicit account only when the normal connection mapping needs recovery.
What You Need to Provide
Use an Amazon Ads connection you own. Keep credentials out of prompts. A report still processing is not a completed result; reuse its reference rather than creating it again.
Advertising changes require a preview and your explicit confirmation. These examples do not authorize changes by themselves.
Multi-request examples have an explicit stopping point. Stop on an error or missing required information rather than continuing indefinitely.
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_amazon_ads_sp_audience_reporthttps://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": "amazon-ads-sp-audience-report-1",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_ads_sp_audience_report",
"arguments": {
"connectionId": 123,
"endDate": "2026-08-07",
"startDate": "2026-08-01"
}
}
}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 | Owned Amazon Ads connection ID; profile and region are resolved by the backend. Example: 123 |
startDate | string | required | Inclusive report start date in YYYY-MM-DD. Example: 2026-08-01 |
endDate | string | required | Inclusive YYYY-MM-DD date, not after today or before startDate. Example: 2026-08-07 |
advertiserAccountId | string | optional | Optional explicit recovery account ID; omitted means unique mapping from the authorized profile. |
timeUnit | string | optional | DAILY or SUMMARY; defaults to DAILY. |
detailLevel | string | optional | ACCOUNT, CAMPAIGN or AD_GROUP; defaults to ACCOUNT. |
Response fields
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
code | integer | required | 0 means accepted or successful; nonzero is a platform error. |
cost | string | required | Elapsed milliseconds, never credits; -1 outside web requests. |
data | any | required | Data value used by this API operation. |
msg | string | null | required | Msg value used by this API operation. |
time | string | required | Server local time: yyyy-MM-dd HH:mm:ss. |
traceId | string | null | required | Trace id value used by this API operation. |
ts | string | required | Epoch milliseconds. |
Any of option 1 — requires reportId
| Name | Type | Required | Description |
|---|---|---|---|
data | object | required | Data value used by this API operation. |
data.completedReportParts | array | optional | Completed CSV parts; each part contains a backend documentToken instead of a signed URL. Example: [] |
data.costTime | integer | optional | Execution time reported by the upstream provider. Example: null |
data.costToken | integer | optional | Token cost reported by the upstream provider. Example: null |
data.dataSnapshotMonth | string | optional | Data snapshot month returned by the upstream provider. Example: null |
data.page | integer | optional | Current page returned by the upstream provider. Example: null |
data.pageItemCount | integer | optional | Item count on the current page returned by the upstream provider. Example: null |
data.pageSize | integer | optional | Page size returned by the upstream provider. Example: null |
data.reportId | string | required | Created or queried report identifier. Example: report-id |
data.reportParts | array | optional | Provider alias for completed parts, when present. Example: [] |
data.sourceTool | string | optional | Provider-specific source tool name. Example: null |
data.sourceType | string | optional | Provider-specific source platform type. Example: null |
data.status | string | optional | Provider report state when present. Example: PENDING |
data.title | string | optional | Provider-specific response title. Example: null |
data.totalPage | integer | optional | Total page count returned by the upstream provider. Example: null |
data.type | string | optional | Provider-specific render or payload type. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data | null | required | Data value used by this API operation. |
Format Illustration
Illustrative example with fictional data, not a live tool call.
Illustrative Question
Request my Sponsored Products audience report for August 1–7, 2026.
Illustrative Response Explanation
The illustrative request returns report-example-001 with status PENDING. The audience report is still being prepared. Keep the report ID and check its status before attempting a download.
About this sample: Illustrative example only. Names, identifiers and numbers are fictional; no live tool call was made. Your results depend on your account, inputs and available data.
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": "amazon-ads-sp-audience-report-example",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_ads_sp_audience_report",
"arguments": {
"connectionId": 123,
"endDate": "2026-08-07",
"startDate": "2026-08-01"
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "amazon-ads-sp-audience-report-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"reportId\":\"report-example-001\",\"status\":\"PENDING\"},\"cost\":\"0\",\"time\":\"2026-01-01 00:00:00\",\"traceId\":null,\"ts\":\"1767225600000\"}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"reportId": "report-example-001",
"status": "PENDING"
},
"cost": "0",
"time": "2026-01-01 00:00:00",
"traceId": null,
"ts": "1767225600000"
},
"isError": false
}
}