Amazon Advertising
Accepts only documented ads_manager.sb/sd/sp operation IDs. Provider methods and paths are derived server-side; mutations require preview followed by confirmation.
nexscope_amazon_advertising/api/skill-api/v1/mcptools/callSend the user API key as a bearer token on every MCP JSON-RPC request.
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.
Use tools/call with the MCP tool name below. The arguments object should match the table on this page.
{
"jsonrpc": "2.0",
"id": "amazon-advertising-1",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_advertising",
"arguments": {
"operationId": "ads_manager.sp.list_campaigns",
"connectionId": 123,
"payload": {
"campaignIdFilter": {
"include": [
"123456789"
]
},
"maxResults": 10
}
}
}
}POST /api/skill-api/v1/mcphttps://www.nexscope.ai/mcp-map/amazon-advertising| Name | Type | Required | Description |
|---|---|---|---|
operationId | string | required | Exact catalog operation ID, for example ads_manager.sp.list_campaigns. Example: ads_manager.sp.list_campaigns |
connectionId | integer | required | Owned Amazon Ads connection ID. Example: 123 |
payload | object | optional | Documented fields for the selected operation; required by create/update operations. SP POST /list filters such as campaignIdFilter and stateFilter belong in payload as objects with non-empty include arrays of strings. Example: {
"campaignIdFilter": {
"include": [
"123456789"
]
},
"maxResults": 10
} |
queryString | string | optional | Optional operation-specific query string without a leading ?; do not use it for SP POST /list filters. Example: |
adType | string | optional | Required only by ads_manager.sb.create_ads. Example: video |
action | string | optional | preview (default) or confirm for mutations; ignored for reads. Example: preview |
confirmationToken | string | optional | Single-use token required when action is confirm. Example: opaque-token |
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.data | object | optional | Safe Amazon Ads provider result. Example: {} |
data.confirmationToken | string | optional | Single-use mutation confirmation token returned by preview. Example: opaque-token |
data.expiresAt | integer | optional | Confirmation expiry timestamp when returned. Example: 1760000000000 |
data.type | string |
{
"operationId": "ads_manager.sp.list_campaigns",
"connectionId": 123,
"payload": {
"campaignIdFilter": {
"include": [
"123456789"
]
},
"maxResults": 10
}
}{
"data": {
"data": {},
"confirmationToken": "opaque-token",
"expiresAt": "1760000000000"
},
"code": 0,
"msg": null,
"ts": "0",
"time": "2026-01-01 00:00:00",
"cost": "-1",
"traceId": null
}| 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. |