Amazon Advertising
Starts Amazon Ads OAuth authorization or returns safe connection and profile metadata. Access and refresh tokens are never accepted or returned.
nexscope_amazon_ads_api_access/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-ads-api-access-1",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_ads_api_access",
"arguments": {
"operation": "authorize",
"accountName": "US Ads account",
"region": "NA",
"marketplaceId": "ATVPDKIKX0DER"
}
}
}POST /api/skill-api/v1/mcphttps://www.nexscope.ai/mcp-map/amazon-ads-api-access| Name | Type | Required | Description |
|---|---|---|---|
operation | string | required | Operation: authorize, connections, or profiles. Example: authorize |
region | string | required | Required when operation=authorize. Amazon Ads region: NA, EU, or FE. Example: NA |
marketplaceId | string | required | Required when operation=authorize. Amazon marketplace identifier. Example: ATVPDKIKX0DER |
accountName | string | optional | Optional display name for the authorization request. Example: US Ads account |
connectionId | integer | optional | Required when operation=profiles. Owned Amazon Ads connection ID. Example: 123 |
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.authorizationUrl | string | optional | OAuth URL to open in a browser. Example: https://example.com/authorize |
data.state | string | optional | Opaque OAuth state used only by the backend callback. Example: opaque-state |
data.expiresAt | integer | optional | Authorization state expiry timestamp in milliseconds. Example: 1760000000000 |
data.connections |
{
"operation": "authorize",
"accountName": "US Ads account",
"region": "NA",
"marketplaceId": "ATVPDKIKX0DER"
}{
"data": {
"authorizationUrl": "https://example.com/authorize",
"state": "opaque-state",
"expiresAt": "1760000000000",
"connections": [],
"profiles": [
{
"profileId": "123456789",
"countryCode": "US",
"currencyCode": "USD"
}
]
},
"code": 0,
"msg": null,
"ts": "0",
"time": "2026-01-01 00:00:00",
"cost": "-1",
"traceId": null
}array |
| optional |
Safe owned Amazon Ads connection metadata. Example: [] |
data.profiles | array | optional | Safe Amazon Ads profiles for the selected connection. Example: [] |
data.profiles[] | object | required | Item in data profiles. |
data.profiles[].profileId | string | optional | Amazon Ads profile ID. Example: 123456789 |
data.profiles[].countryCode | string | optional | Profile country code. Example: US |
data.profiles[].currencyCode | string | optional | Profile currency code. Example: USD |
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. |