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

Equivalent REST API path

https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-ads-api-access/run

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

REST API equivalent

POST https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-ads-api-access/run

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	Meaning
`authorizationUrl`	`string`	optional	OAuth URL to open in a browser. Example: https://example.com/authorize
`state`	`string`	optional	Opaque OAuth state used only by the backend callback. Example: opaque-state
`expiresAt`	`integer`	optional	Authorization state expiry timestamp in milliseconds. Example: 1760000000000
`connections`	`array`	optional	Safe owned Amazon Ads connection metadata. Example: []
`profiles`	`array`	optional	Safe Amazon Ads profiles for the selected connection. Example: []
`profiles[].profileId`	`string`	optional	Amazon Ads profile ID. Example: 123456789
`profiles[].countryCode`	`string`	optional	Profile country code. Example: US
`profiles[].currencyCode`	`string`	optional	Profile currency code. Example: USD
`errcode`	`integer`	optional	Upstream status code returned by the provider. Example: {}
`errmsg`	`string`	optional	Upstream status message returned by the provider. Example: {}
`code`	`string`	optional	Provider-specific status code. Example: {}
`msg`	`string`	optional	Provider-specific status message. Example: {}
`message`	`string`	optional	Provider-specific message. Example: {}
`type`	`string`	optional	Provider-specific render or payload type. Example: {}
`title`	`string`	optional	Provider-specific response title. Example: {}
`sourceType`	`string`	optional	Provider-specific source platform type. Example: {}
`sourceTool`	`string`	optional	Provider-specific source tool name. Example: {}
`costToken`	`integer`	optional	Token cost reported by the upstream provider. Example: {}
`costTime`	`integer`	optional	Execution time reported by the upstream provider. Example: {}
`page`	`integer`	optional	Current page returned by the upstream provider. Example: {}
`pageSize`	`integer`	optional	Page size returned by the upstream provider. Example: {}
`pageItemCount`	`integer`	optional	Item count on the current page returned by the upstream provider. Example: {}
`totalPage`	`integer`	optional	Total page count returned by the upstream provider. Example: {}
`dataSnapshotMonth`	`string`	optional	Data snapshot month returned by the upstream provider. Example: {}

Examples

Example arguments

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

Example structuredContent

{
  "authorizationUrl": "https://example.com/authorize",
  "state": "opaque-state",
  "expiresAt": "1760000000000",
  "connections": [],
  "profiles": [
    {
      "profileId": "123456789",
      "countryCode": "US",
      "currencyCode": "USD"
    }
  ]
}