`microsoft_ads_list_negative_keyword_lists`

List Microsoft Ads Negative Keyword Lists

Microsoft

Description

Read-onlyOpen-world

Usage

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

hopkin microsoft negative-keyword-lists list

Flag	Type	Required	Description
`--account`	`string`	Required	Microsoft Advertising account ID (AccountId) whose shared library to read.
`--customer-id`	`string`	Optional	Customer/manager ID (CustomerId). Required for agency-managed accounts.
`--list-id`	`string`	Optional	Return only this negative keyword list, with its keywords paged: each page holds as many as fit in a response an MCP client accepts (at most max_keywords_per_list), starting at keywordsOffset, and nextCursor continues them. The way to read every keyword of a list that came back with keywordsTruncated: true.
`--include-keywords`	`boolean`	Optional	Embed each list's negative keywords (text + match type). Defaults to true; set false for a names-and-counts overview.
`--include-campaign-associations`	`boolean`	Optional	Embed the campaigns each list is applied to (id, name, status). Defaults to true.
`--max-keywords-per-list`	`integer`	Optional	Most keywords to embed per list (1-5000, default 50). With list_id it caps one page of that list's keywords instead, and by default a page takes as many as fit. A list cut short has keywordsTruncated: true; keywordCount is always the full size.
`--max-campaigns-per-list`	`integer`	Optional	Most campaigns to embed per shared list, first by name (1-10000, default 100). A list cut short has campaignsTruncated: true; associationCount is always the full count. With list_id the campaigns come on the first page only, cut to fit the response.
`--limit`	`integer`	Optional	Lists per page (1-20). Default: as many lists as fit in a response an MCP client accepts (about 45K characters, at most 20). 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) whose shared library to read.minLength: 1, maxLength: 20, pattern: ^\d+$
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (9)

Name	Type	Required	Description
`customer_id`	`string`	Optional	Customer/manager ID (CustomerId). Required for agency-managed accounts.minLength: 1, maxLength: 20, pattern: ^\d+$
`list_id`	`string`	Optional	Return only this negative keyword list, with its keywords paged: each page holds as many as fit in a response an MCP client accepts (at most max_keywords_per_list), starting at keywordsOffset, and nextCursor continues them. The way to read every keyword of a list that came back with keywordsTruncated: true.minLength: 1, maxLength: 20, pattern: ^\d+$
`include_keywords`	`boolean`	Optional	Embed each list's negative keywords (text + match type). Defaults to true; set false for a names-and-counts overview.
`include_campaign_associations`	`boolean`	Optional	Embed the campaigns each list is applied to (id, name, status). Defaults to true.
`max_keywords_per_list`	`integer`	Optional	Most keywords to embed per list (1-5000, default 50). With list_id it caps one page of that list's keywords instead, and by default a page takes as many as fit. A list cut short has keywordsTruncated: true; keywordCount is always the full size.min: 1, max: 5000
`max_campaigns_per_list`	`integer`	Optional	Most campaigns to embed per shared list, first by name (1-10000, default 100). A list cut short has campaignsTruncated: true; associationCount is always the full count. With list_id the campaigns come on the first page only, cut to fit the response.min: 1, max: 10000
`limit`	`integer`	Optional	Lists per page (1-20). Default: as many lists as fit in a response an MCP client accepts (about 45K characters, at most 20). Follow nextCursor for the rest.min: 1, max: 20
`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