x_ads_update_line_item

Update a line item's bid, budget, name, schedule, placements, goal, pacing, audience expansion (set audience_expansion=EXPANDED to turn on Optimized…

Update a line item's bid, budget, name, schedule, placements, goal, pacing, audience expansion (set audience_expansion=EXPANDED to turn on Optimized Targeting) or entity_status. Set entity_status=PAUSED to pause this ad group; pausing is only possible here, and activate_line_item is the only way to make it eligible to spend again. Preview by default. Ask the user to approve the exact account, target and parameters before confirm:true.

Source: X Ads
Kind: Write
Discovery: Reachable through search_tools and run_tool
Account parameter: account_id
Endpoint: https://mcp.getmcpads.com/x-ads/mcp

ParametersLink to this section

Name	Type	Required	Notes
`account_id`	string	Required	X Ads account ID selected in Sources.
`advertiser_domain`	string	Optional	New website domain of the advertiser (no protocol); required when placements includes PUBLISHER_N...
`android_app_store_identifier`	string	Optional	New Google Play package name of the promoted app, e.g. com.example.app.
`audience_expansion`	string	Optional	New audience expansion level; EXPANDED turns on what Ads Manager calls Optimized Targeting (off b... One of: `BROAD`, `DEFINED`, `EXPANDED`.
`bid_amount_local_micro`	integer	Optional	New bid in micros of the account currency; only with bid_strategy MAX or TARGET.
`bid_strategy`	string	Optional	New bidding strategy. One of: `AUTO`, `MAX`, `TARGET`.
`categories`	string	Optional	New comma-separated IAB content category IDs, e.g. IAB3-1,IAB19 (see list_iab_categories).
`daily_budget_amount_local_micro`	integer	Optional	New line item daily budget in micros.
`duration_in_days`	integer	Optional	New frequency_cap window (1, 7 or 30 days); set together with frequency_cap.
`end_time`	string	Optional	New end time (ISO 8601).
`entity_status`	string	Optional	Set PAUSED to pause this ad group (the only pause path). Resume with activate_line_item. One of: `PAUSED`.
`frequency_cap`	integer	Optional	New maximum times an ad can be delivered to a user within duration_in_days.
`goal`	string	Optional	New optimization goal (e.g. ENGAGEMENT, LINK_CLICKS, SITE_VISITS, WEBSITE_CONVERSIONS, FOLLOWERS,...
`ios_app_store_identifier`	string	Optional	New numeric Apple App Store ID of the promoted app, e.g. 333903271.
`line_item_id`	string	Required	Line item ID belonging to the selected X Ads account.
`name`	string	Optional	New line item name (1-255 characters).
`pay_by`	string	Optional	New unit to pay by. Only settable for APP_INSTALLS (APP_CLICK or APP_INSTALL) and REACH (IMPRESSI... One of: `APP_CLICK`, `APP_INSTALL`, `ENGAGEMENT`, `FOLLOW`, `IMPRESSION`, `LINK_CLICK`, `VIEW`, `VIEW_3S_100PCT`, `VIEW_6S`, `VIDEO_START`.
`placements`	string	Optional	New comma-separated placements, e.g. ALL_ON_TWITTER or TWITTER_TIMELINE,TWITTER_PROFILE. Valid va...
`primary_web_event_tag`	string	Optional	New website conversion tag (pixel) id; see list_web_event_tags.
`standard_delivery`	boolean	Optional	true paces spend evenly through the day; false spends as fast as possible (accelerated delivery, ...
`start_time`	string	Optional	New start time (ISO 8601).
`total_budget_amount_local_micro`	integer	Optional	New line item total budget in micros.
`confirm`	boolean	Optional	False previews only; true applies this exact change after explicit human confirmation. Default: `false`.

Calling itLink to this section

jsonThrough run_tool, since it is not announced

{
  "name": "run_tool",
  "arguments": {
    "name": "x_ads_update_line_item",
    "args": {
      "account_id": "<string>",
      "line_item_id": "<string>"
    }
  }
}