Amazon Advertising
Amazon Ads SP Audience Report using an owned Amazon Ads connection.
nexscope_amazon_ads_sp_audience_reporthttps://api.nexscope.ai/api/skill-api/v2/mcptools/callUse OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope for standard remote clients. API keys remain supported as a compatibility option while v1 integrations migrate.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxIf authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.
Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/api/skill-api/v2/mcp, then use tools/call with the MCP tool name below. The arguments object should match the table on this page.
{
"jsonrpc": "2.0",
"id": "amazon-ads-sp-audience-report-1",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_ads_sp_audience_report",
"arguments": {
"connectionId": 123,
"startDate": "2026-08-01",
"endDate": "2026-08-07"
}
}
}MCP 2025-11-25 · Streamable HTTPhttps://www.nexscope.ai/mcp-map/amazon-ads-sp-audience-reportProgress is delivered on the original POST SSE response when the client supplies a progress token and the tool has real execution stages. GET SSE carries server notifications such as tool-list changes. Creating an asynchronous task or calling an external provider may consume credits; reconnecting must query the existing task instead of submitting it again.
| 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. Example: {} |
timeUnit | string | optional | DAILY or SUMMARY; defaults to DAILY. Example: {} |
detailLevel | string | optional | ACCOUNT, CAMPAIGN or AD_GROUP; defaults to ACCOUNT. Example: {} |
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
data | any | required | Data value used by this API operation. |
code | integer | required | 0 means accepted or successful; nonzero is a platform error. |
msg | string | null | required | Msg value used by this API operation. |
ts | string | required | Epoch milliseconds. |
time | string | required | Server local time: yyyy-MM-dd HH:mm:ss. |
cost | string | required | Elapsed milliseconds, never credits; -1 outside web requests. |
traceId | string | null | required | Trace id value used by this API operation. |
| Name | Type | Required | Description |
|---|---|---|---|
data | object | required | Data value used by this API operation. |
data.reportId | string | required | Created or queried report identifier. Example: report-id |
data.status | string | optional | Provider report state when present. Example: PENDING |
data.completedReportParts | array | optional | Completed CSV parts; each part contains a backend documentToken instead of a signed URL. Example: [] |
data.reportParts |
{
"connectionId": 123,
"startDate": "2026-08-01",
"endDate": "2026-08-07"
}{
"data": {
"status": "PENDING",
"reportId": "report-id"
},
"code": 0,
"msg": null,
"ts": "0",
"time": "2026-01-01 00:00:00",
"cost": "-1",
"traceId": null
}array |
| optional |
Provider alias for completed parts, when present. Example: [] |
data.type | string | optional | Provider-specific render or payload type. Example: null |
data.title | string | optional | Provider-specific response title. Example: null |
data.sourceType | string | optional | Provider-specific source platform type. Example: null |
data.sourceTool | string | optional | Provider-specific source tool name. Example: null |
data.costToken | integer | optional | Token cost reported by the upstream provider. Example: null |
data.costTime | integer | optional | Execution time reported by the upstream provider. Example: null |
data.page | integer | optional | Current page returned by the upstream provider. Example: null |
data.pageSize | integer | optional | Page size 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.totalPage | integer | optional | Total page count returned by the upstream provider. Example: null |
data.dataSnapshotMonth | string | optional | Data snapshot month returned by the upstream provider. Example: null |
| Name | Type | Required | Description |
|---|---|---|---|
data | null | required | Data value used by this API operation. |