x_ads_list_line_items

List line items (ad groups) for an ads account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account…

List line items (ad groups) for an ads account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.

Source: X Ads
Kind: Read
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.
`campaign_ids`	string	Optional	Comma-separated campaign IDs to scope the line items to.
`count`	integer	Optional	Number of records to return per page (1-1000).
`cursor`	string	Optional	Pagination cursor from a previous response.
`funding_instrument_ids`	string	Optional	Comma-separated funding instrument IDs to scope the results to (max 200).
`line_item_ids`	string	Optional	Comma-separated line item IDs to fetch specific records (max 200).
`q`	string	Optional	Search by line item name (1-255 characters).
`sort_by`	string	Optional	Sort order as attribute-direction, e.g. created_at-asc or updated_at-desc.
`with_deleted`	boolean	Optional	Include soft-deleted line items in the response (default false).
`with_draft`	boolean	Optional	Include line items of draft campaigns in the response (default false).
`with_total_count`	boolean	Optional	Include the total_count response attribute (default false; exclusive with cursor).

Calling itLink to this section

jsonThrough run_tool, since it is not announced

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