x_ads_create_ad_post

Compose a promoted-only ("nullcasted") post to use as an ad creative. A write tool that previews before it changes anything, one of 26 X Ads tools…

Compose a promoted-only ("nullcasted") post to use as an ad creative. The post never appears on the author's profile or followers' timelines and spends nothing by itself ; attach it to a line item with promote_post. 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.
`as_user_id`	string	Required	User ID to post on behalf of (must be a promotable user of the account, e.g. the account's own ha...
`card_uri`	string	Optional	Card URI to attach (e.g. a website card).
`conversation_settings`	string	Optional	Who can reply to the post (default EVERYONE). One of: `EVERYONE`, `FOLLOWING`, `MENTIONED_USERS`.
`media_keys`	string	Optional	Comma-separated media keys of pre-uploaded media to attach (required unless text is provided).
`text`	string	Optional	Post text (required unless media_keys is provided).
`trim_user`	boolean	Optional	Return only the author's user ID instead of the full user object in the response (default false).
`tweet_mode`	string	Optional	Response rendering mode (default compat). One of: `compat`, `extended`.
`video_cta`	string	Optional	Call-to-action button on an attached video; set the target URL with video_cta_value. One of: `VISIT_SITE`, `WATCH_NOW`.
`video_cta_value`	string	Optional	Destination URL for the video_cta button; required when video_cta is set.
`video_description`	string	Optional	Description shown under an attached video (1-200 characters).
`video_title`	string	Optional	Title shown under an attached video (1-70 characters).
`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_create_ad_post",
    "args": {
      "account_id": "<string>",
      "as_user_id": "<string>"
    }
  }
}