Skip to main content
POST
Add Sponsored Products negative keywords at ad group level (default) or campaign level. A negative only narrows targeting, so it is created ENABLED. Takes the negative_candidate objects of analyze_amazon_wasted_spend once mapped to keyword_text / match_type. Staged for dashboard approval; nothing changes in Amazon before a person approves it.
Change — approval required. Calling this tool does not change your ad account. ADSMCP checks the arguments and stages the change as a pending action. It runs only after a person approves it on the dashboard Approvals page. Over MCP or REST you can view (list_pending_actions) or reject (manage_action) it, never approve it. execution_mode and similar arguments do not skip the queue.A change that fails when it runs is not retried automatically. It shows on the dashboard Execution Queue.
Add Sponsored Products negative keywords at ad group level (default) or campaign level. A negative only narrows targeting, so it is created ENABLED. Takes the negative_candidate objects of analyze_amazon_wasted_spend once mapped to keyword_text / match_type. Staged for dashboard approval; nothing changes in Amazon before a person approves it. Platform: Amazon Ads · Type: Change

How to call it

  • MCP: on https://mcp.adsmcp.si/mcp, run it through the amazon_ads_write tool with {"action": "execute", "tool_name": "add_amazon_negative_keywords", "arguments": { ... }}, or call add_amazon_negative_keywords by name. search_tools finds it and get_tool_schema returns its arguments; https://mcp.adsmcp.si/mcp/flat lists every tool by name.
  • REST: POST https://mcp.adsmcp.si/api/v1/tools/add_amazon_negative_keywords/execute with Authorization: Bearer sk_live_... and a JSON body {"platform": "amazon", "arguments": { ... }}. The arguments are listed below; they are exactly the tool’s input schema.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Authorization
string
required

Bearer token

Idempotency-Key
string

Body

application/json
platform
string
default:amazon
arguments
object

Response

Tool execution result.

ok
boolean
required
platform
string
required
tool
string
required
error
null | object
required
mcp_response
any
required
data
any