`microsoft_ads_list_negative_keywords`

List Microsoft Ads Negative Keywords

Microsoft

Description

Read-onlyOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "microsoft_ads_list_negative_keywords",
    "arguments": {}
  }
}

hopkin microsoft negative-keywords list

Flag	Type	Required	Description
`--account`	`string`	Required	Microsoft Advertising account ID (AccountId).
`--customer-id`	`string`	Optional	Customer/manager ID (CustomerId). Required for agency-managed accounts.
`--campaign-ids`	`array`	Optional	Only these campaigns (1-100): their own negatives and, unless level is Campaign, their ad groups'. Omit for the whole account. An id the account does not have is rejected.
`--ad-group-ids`	`array`	Optional	Only these ad groups (1-100); implies level AdGroup (level Campaign is rejected). Each ad group's campaign is looked up; pass campaign_ids too when an ad group has not been listed before.
`--level`	`string`	Optional	Campaign = negatives added to campaigns, AdGroup = to ad groups, All (default) = both.
`--match-type`	`array`	Optional	Only these match types. Microsoft negatives are Exact or Phrase.
`--limit`	`integer`	Optional	Negative keywords per page (1-100). Default: as many as fit in a response an MCP client accepts (about 45K characters). Follow nextCursor for the rest.
`--cursor`	`string`	Optional	Opaque cursor from the previous response's nextCursor. Pass it with otherwise identical parameters to get the next page; a cursor reused with different filters is rejected. Omit for the first page.
`--connection-id`	`string`	Optional	Optional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.

{
  "mcpServers": {
    "microsoft-ads": {
      "url": "https://microsoft.mcp.hopkin.ai",
      "transport": "sse"
    }
  }
}

Parameters

Name	Type	Required	Description
`account_id`	`string`	Required	Microsoft Advertising account ID (AccountId).minLength: 1, maxLength: 20, pattern: ^\d+$
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (8)

Name	Type	Required	Description
`customer_id`	`string`	Optional	Customer/manager ID (CustomerId). Required for agency-managed accounts.minLength: 1, maxLength: 20, pattern: ^\d+$
`campaign_ids`	`array`	Optional	Only these campaigns (1-100): their own negatives and, unless level is Campaign, their ad groups'. Omit for the whole account. An id the account does not have is rejected.
`ad_group_ids`	`array`	Optional	Only these ad groups (1-100); implies level AdGroup (level Campaign is rejected). Each ad group's campaign is looked up; pass campaign_ids too when an ad group has not been listed before.
`level`	`string`	Optional	Campaign = negatives added to campaigns, AdGroup = to ad groups, All (default) = both. `Campaign` `AdGroup` `All`
`match_type`	`array`	Optional	Only these match types. Microsoft negatives are Exact or Phrase.
`limit`	`integer`	Optional	Negative keywords per page (1-100). Default: as many as fit in a response an MCP client accepts (about 45K characters). Follow nextCursor for the rest.min: 1, max: 100
`cursor`	`string`	Optional	Opaque cursor from the previous response's nextCursor. Pass it with otherwise identical parameters to get the next page; a cursor reused with different filters is rejected. Omit for the first page.minLength: 1
`connection_id`	`string`	Optional	Optional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.

Description

Usage

Parameters

Related Tools