X Ads MCP Server

Activate a campaign (set entity_status=ACTIVE). This makes the campaign eligible to serve ads and SPEND REAL MONEY once its line items are also active. This is the only tool that can activate a campaign; confirm with the advertiser before calling it. Preview by default. Ask the user to approve the exact account, target and parameters before confirm:true.

Activate a line item (set entity_status=ACTIVE). Once its parent campaign is also active, the line item becomes eligible to serve ads and SPEND REAL MONEY. This is the only tool that can activate a line item; confirm with the advertiser before calling it. Preview by default. Ask the user to approve the exact account, target and parameters before confirm:true.

Add one targeting criterion to a line item (call once per criterion). A line item with no criteria serves broad ; that is allowed, not an error. Preview by default. Ask the user to approve the exact account, target and parameters before confirm:true.

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.

Create a campaign in an ads account. The campaign is ALWAYS created with entity_status PAUSED ; it cannot serve or spend until explicitly activated with activate_campaign. Campaigns are always created with budget_optimization LINE_ITEM (the only mode ads-api still supports), so budgets are NOT set here: set daily_budget_amount_local_micro on each line item via create_line_item. Schedule (start_time/end_time) and pacing (standard_delivery) also live on line items, not campaigns, in ads-api v12. Preview by default. Ask the user to approve the exact account, target and parameters before confirm:true.

Create a line item (ad group) under a campaign. The line item is ALWAYS created with entity_status PAUSED ; it cannot serve or spend until explicitly activated with activate_line_item. For website conversion campaigns, set goal=WEBSITE_CONVERSIONS and primary_web_event_tag to a web event tag (pixel) id from list_web_event_tags. Preview by default. Ask the user to approve the exact account, target and parameters before confirm:true.

Get synchronous analytics (impressions, engagements, spend) for an ads account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.

List which ads entities had metrics change in a time window (use before requesting account stats) Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.

Get a single campaign by ID Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.

Get reach and average-frequency metrics for campaigns Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.

Get a single line item by ID Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.

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.

List the ads accounts the authenticated user can access Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.

List campaigns for an account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.

List funding instruments (payment sources) for an ads account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.

List valid placement combinations per line item product type Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.

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.

List promoted posts (promoted tweets) for an ads account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.

List targeting criteria for an ads account's line items Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.

List the website conversion event tags (pixels) in an ads account; a tag's id is what a conversion line item takes as its primary_web_event_tag Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.

Attach post(s) to a line item as its ad creative(s). Promoted posts have no entity_status of their own ; they cannot serve while the parent line item or campaign is paused. The response carries each post's approval_status (ads enter review before serving). Preview by default. Ask the user to approve the exact account, target and parameters before confirm:true.

Remove a targeting criterion from its line item (undo a targeting mistake). Criterion IDs come from list_targeting_criteria or the add response. Preview by default. Ask the user to approve the exact account, target and parameters before confirm:true.

Search targetable interest categories by name. Use this to find the targeting_value IDs required by add_targeting_criterion for INTEREST-type criteria. Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.

Search targetable locations by name. Use this to find the targeting_value IDs required by add_targeting_criterion for LOCATION-type criteria. Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.

Rename a campaign or pause it (entity_status=PAUSED). This tool can pause but CANNOT activate ; use activate_campaign to make a campaign eligible to spend. Budgets and schedule live on line items in ads-api v12: use update_line_item to change them. Preview by default. Ask the user to approve the exact account, target and parameters before confirm:true.

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.