x_ads_list_account_posts

List posts (tweets) usable for promotion by an ads account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths…

List posts (tweets) usable for promotion by 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.
`count`	integer	Optional	Number of records to return per page (1-1000).
`cursor`	string	Optional	Pagination cursor from a previous response.
`include_mentions_and_replies`	boolean	Optional	Include mentions and replies in the results (default false).
`timeline_type`	string	Optional	Scope to promoted-only, organic or all posts (default NULLCAST). One of: `ALL`, `NULLCAST`, `ORGANIC`.
`trim_user`	boolean	Optional	Return only the author's user ID instead of the full user object (default false).
`tweet_ids`	string	Optional	Comma-separated post (tweet) IDs to scope the response to.
`tweet_type`	string	Required	Post type to list (the legacy API requires this filter). One of: `PUBLISHED`, `SCHEDULED`, `DRAFT`.
`user_id`	string	Optional	Promotable user whose posts to list (defaults to the account's own user).

Calling itLink to this section

jsonThrough run_tool, since it is not announced

{
  "name": "run_tool",
  "arguments": {
    "name": "x_ads_list_account_posts",
    "args": {
      "account_id": "<string>",
      "tweet_type": "PUBLISHED"
    }
  }
}