Amazon Advertising

Amazon Ads API Access MCP Tool

Starts Amazon Ads OAuth authorization or returns safe connection and profile metadata. Access and refresh tokens are never accepted or returned.

MCP tool name

nexscope_amazon_ads_api_access

Legacy MCP endpoint

/api/skill-api/v1/mcp

JSON-RPC method

tools/call

Authentication

Send the user API key as a bearer token on every MCP JSON-RPC request.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.

Call this MCP 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": {
      "region": "NA",
      "marketplaceId": "ATVPDKIKX0DER",
      "operation": "authorize",
      "accountName": "US Ads account"
    }
  }
}

Legacy endpoint

POST /api/skill-api/v1/mcp

Canonical detail URL

https://www.nexscope.ai/mcp-map/amazon-ads-api-access

Arguments

Name	Type	Required	Meaning
`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

Response fields

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.

Any of option 1

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`	`array`	optional	Safe owned Amazon Ads connection metadata. Example: []
`data.profiles`	`array`	optional	Safe Amazon Ads profiles for the selected connection. Example: []
`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

Any of option 2

Name	Type	Required	Description
`data`	`null`	required	Data value used by this API operation.

Examples

Example arguments

{
  "region": "NA",
  "marketplaceId": "ATVPDKIKX0DER",
  "operation": "authorize",
  "accountName": "US Ads account"
}

Example structuredContent

{
  "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
}