X Ads MCP Server

Read campaigns and performance, inspect targeting and prepare changes for explicitly selected accounts.

Local serverstdioApache-2.0

What is the X Ads MCP Server?

X Ads is an MCP project maintained in the get-mcp-ads/x-ads-mcp-server repository. The maintainer describes its purpose as “Read campaigns and performance, inspect targeting and prepare changes for explicitly selected accounts”. Read the project documentation for the complete scope.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-09.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
x_ads_list_ads_accountsList the ads accounts the authenticated user can access
x_ads_list_campaignsList campaigns for an account
x_ads_get_campaignGet a single campaign by ID
x_ads_list_funding_instrumentsList funding instruments (payment sources) for an ads account
x_ads_list_line_itemsList line items (ad groups) for an ads account
x_ads_get_line_itemGet a single line item by ID
x_ads_list_promoted_postsList promoted posts (promoted tweets) for an ads account
x_ads_list_targeting_criteriaList targeting criteria for an ads account's line items
x_ads_list_account_postsList posts (tweets) usable for promotion by an ads account
x_ads_list_web_event_tagsList 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
x_ads_list_line_item_placementsList valid placement combinations per line item product type
x_ads_get_account_statsGet synchronous analytics (impressions, engagements, spend) for an ads account
x_ads_get_active_entitiesList which ads entities had metrics change in a time window (use before requesting account stats)
x_ads_get_campaign_reachGet reach and average-frequency metrics for campaigns
x_ads_search_targeting_interestsSearch targetable interest categories by name.
x_ads_search_targeting_locationsSearch targetable locations by name.
x_ads_list_cardsList the cards in an ads account
x_ads_get_cardGet a single card by ID
x_ads_list_media_libraryList the media library objects in an ads account
x_ads_get_media_library_itemGet a single media library object by media key
x_ads_get_promoted_postGet a single promoted post by ID
x_ads_get_targeting_criterionGet a single targeting criterion by ID
x_ads_list_post_previewsGet rendered HTML previews for published or scheduled posts
x_ads_get_web_event_tagGet a single website conversion event tag by ID
x_ads_get_media_upload_statusRead processing status of an upload owned by the connected X user.
x_ads_create_campaignCreate a campaign in an ads account.
x_ads_update_campaignRename a campaign or pause it (entity_status=PAUSED).
x_ads_activate_campaignActivate a campaign (set entity_status=ACTIVE).
x_ads_create_line_itemCreate a line item (ad group) under a campaign.
x_ads_update_line_itemUpdate a line item's bid, budget, name, schedule, placements, goal, pacing, audience expansion (set audience_expansion=EXPANDED to turn on Optimized…
x_ads_activate_line_itemActivate a line item (set entity_status=ACTIVE).
x_ads_promote_postAttach post(s) to a line item as its ad creative(s).
x_ads_add_targeting_criterionAdd one targeting criterion to a line item (call once per criterion).
x_ads_remove_targetingRemove a targeting criterion from its line item (undo a targeting mistake).
x_ads_create_ad_postCompose a promoted-only ("nullcasted") post to use as an ad creative.
x_ads_create_cardCreate a card from a JSON components payload.
x_ads_delete_cardDelete a card from an ads account.
x_ads_create_media_library_itemRegister an existing media key as a named item in the account's media library.
x_ads_delete_media_library_itemDelete a media library object from an ads account Preview by default.
x_ads_update_media_library_itemUpdate a media library object's metadata (e.g. name, title, description) Preview by default.
x_ads_create_web_event_tagCreate a website conversion event tag (pixel); the returned id can be set as a line item's primary_web_event_tag Preview by default.
x_ads_delete_web_event_tagDelete a website conversion event tag Preview by default.
x_ads_update_web_event_tagUpdate a website conversion event tag Preview by default.
x_ads_upload_mediaUpload an image, GIF or MP4 clip to X.