Amazon Ads

Amazon Ads Access

Connect an Amazon Ads account and check its connection status. Call the Amazon Ads Access API via REST or MCP from 10 credits per call.

MCP tool name

nexscope_amazon_ads_api_access

MCP endpoint

https://api.nexscope.ai/mcp

JSON-RPC method

tools/call

Authentication

Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication fails, ask the user to open API Access and copy a valid key.

Call this MCP tool

Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.

{
  "jsonrpc": "2.0",
  "id": "amazon-ads-api-access-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_ads_api_access",
    "arguments": {
      "accountName": "US Ads account",
      "marketplaceId": "ATVPDKIKX0DER",
      "operation": "authorize",
      "region": "NA"
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

Progress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.

Arguments

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

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`authorizeUrl`	`string`	optional	Amazon Ads OAuth authorization URL. Example: {}
`sourceType`	`string`	optional	Authorization source identifier, fixed to `amazon_ads`. Example: {}

Examples

Example arguments

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

Example structuredContent

{
  "code": 0,
  "cost": "-1",
  "data": {},
  "msg": null,
  "time": "2026-01-01 00:00:00",
  "traceId": null,
  "ts": "0"
}