> ## Documentation Index
> Fetch the complete documentation index at: https://x-preview-mintlify-93ac23a1.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# X Ads MCP API Reference

> Reference mapping each X Ads MCP tool to its backing Ads API endpoint.

## API Reference Guide

The 74 tools are backed by the following Ads API endpoints (74 routes, served through the x-api gateway at major version `/12`):

| Method | Path | Used by tool |
| :- | :- | :- |
| GET | [`/12/accounts`](/x-ads-api/campaign-management/reference#get-accounts) | `list_ads_accounts` |
| GET | [`/12/accounts/:account_id/campaigns`](/x-ads-api/campaign-management/reference#get-accounts/account_id/campaigns) | `list_campaigns` |
| GET | [`/12/accounts/:account_id/campaigns/:campaign_id`](/x-ads-api/campaign-management/reference#get-accounts/account_id/campaigns/campaign_id) | `get_campaign` |
| GET | [`/12/accounts/:account_id/line_items`](/x-ads-api/campaign-management/reference#get-accounts/account_id/line_items) | `list_line_items` |
| GET | [`/12/accounts/:account_id/line_items/:line_item_id`](/x-ads-api/campaign-management/reference#get-accounts/account_id/line_items/line_item_id) | `get_line_item` |
| GET | [`/12/line_items/placements`](/x-ads-api/campaign-management/reference#get-line_items/placements) | `list_line_item_placements` |
| GET | [`/12/accounts/:account_id/funding_instruments`](/x-ads-api/campaign-management/reference#get-accounts/account_id/funding_instruments) | `list_funding_instruments` |
| GET | [`/12/accounts/:account_id/funding_instruments/:funding_instrument_id`](/x-ads-api/campaign-management/reference#get-accounts/account_id/funding_instruments/funding_instrument_id) | `get_funding_instrument` |
| GET | [`/12/accounts/:account_id/promoted_tweets`](/x-ads-api/campaign-management/reference#get-accounts/account_id/promoted_tweets) | `list_promoted_posts` |
| GET | [`/12/accounts/:account_id/promoted_tweets/:promoted_tweet_id`](/x-ads-api/campaign-management/reference#get-accounts/account_id/promoted_tweets/promoted_tweet_id) | `get_promoted_post` |
| GET | [`/12/accounts/:account_id/tweets`](/x-ads-api/creatives/reference#get-accounts/account_id/tweets) | `list_account_posts` |
| GET | [`/12/stats/accounts/:account_id/active_entities`](/x-ads-api/analytics#get-stats/accounts/account_id/active_entities) | `get_active_entities` |
| GET | [`/12/stats/accounts/:account_id`](/x-ads-api/analytics#get-stats/accounts/account_id) | `get_account_stats` |
| GET | [`/12/stats/accounts/:account_id/reach/campaigns`](/x-ads-api/analytics#get-stats/accounts/account_id/reach/campaigns) | `get_campaign_reach` |
| GET | [`/12/targeting_criteria/interests`](/x-ads-api/campaign-management/reference#get-targeting_criteria/interests) | `search_targeting_interests` |
| GET | [`/12/targeting_criteria/locations`](/x-ads-api/campaign-management/reference#get-targeting_criteria/locations) | `search_targeting_locations` |
| GET | [`/12/accounts/:account_id/targeting_criteria`](/x-ads-api/campaign-management/reference#get-accounts/account_id/targeting_criteria) | `list_targeting_criteria` |
| GET | [`/12/accounts/:account_id/targeting_criteria/:targeting_criterion_id`](/x-ads-api/campaign-management/reference#get-accounts/account_id/targeting_criteria/targeting_criterion_id) | `get_targeting_criterion` |
| POST | [`/12/accounts/:account_id/audience_estimate`](/x-ads-api/campaign-management/reference#audience-estimate) | `estimate_audience` |
| GET | [`/12/accounts/:account_id/custom_audiences`](/x-ads-api/audiences/reference#get-accounts/account_id/custom_audiences) | `list_custom_audiences` |
| GET | [`/12/accounts/:account_id/custom_audiences/:custom_audience_id`](/x-ads-api/audiences/reference#get-accounts/account_id/custom_audiences/custom_audience_id) | `get_custom_audience` |
| POST | [`/12/accounts/:account_id/custom_audiences`](/x-ads-api/audiences/reference#post-accounts/account_id/custom_audiences) | `create_custom_audience` |
| PUT | [`/12/accounts/:account_id/custom_audiences/:custom_audience_id`](/x-ads-api/audiences/reference#put-accounts/account_id/custom_audiences/custom_audience_id) | `update_custom_audience` |
| DELETE | [`/12/accounts/:account_id/custom_audiences/:custom_audience_id`](/x-ads-api/audiences/reference#delete-accounts/account_id/custom_audiences/custom_audience_id) | `delete_custom_audience` |
| GET | [`/12/accounts/:account_id/custom_audiences/:custom_audience_id/targeted`](/x-ads-api/audiences/reference#get-accounts/account_id/custom_audiences/custom_audience_id/targeted) | `list_custom_audience_targeted` |
| GET | [`/12/accounts/:account_id/do_not_reach_lists`](/x-ads-api/audiences/reference#get-accounts/account_id/do_not_reach_lists) | `list_do_not_reach_lists` |
| POST | [`/12/accounts/:account_id/do_not_reach_lists`](/x-ads-api/audiences/reference#post-accounts/account_id/do_not_reach_lists) | `create_do_not_reach_list` |
| DELETE | [`/12/accounts/:account_id/do_not_reach_lists/:do_not_reach_list_id`](/x-ads-api/audiences/reference#delete-accounts/account_id/do_not_reach_lists/do_not_reach_list_id) | `delete_do_not_reach_list` |
| POST | [`/12/batch/accounts/:account_id/do_not_reach_lists/:do_not_reach_list_id/users`](/x-ads-api/audiences/reference#post-batch/accounts/account_id/do_not_reach_lists/do_not_reach_list_id/users) | `batch_do_not_reach_list_users` |
| GET | `/12/accounts/:account_id/cards` | `list_cards` |
| GET | `/12/accounts/:account_id/cards/:card_id` | `get_card` |
| POST | [`/12/accounts/:account_id/cards`](/x-ads-api/creatives/reference#post-accounts/account_id/cards) | `create_card` |
| DELETE | `/12/accounts/:account_id/cards/:card_id` | `delete_card` |
| GET | [`/12/accounts/:account_id/media_library`](/x-ads-api/creatives/reference#get-accounts/account_id/media_library) | `list_media_library` |
| GET | `/12/accounts/:account_id/media_library/:media_key` | `get_media_library_item` |
| POST | `/12/accounts/:account_id/media_library` | `create_media_library_item` |
| PUT | `/12/accounts/:account_id/media_library/:media_key` | `update_media_library_item` |
| DELETE | `/12/accounts/:account_id/media_library/:media_key` | `delete_media_library_item` |
| GET | [`/12/accounts/:account_id/account_media`](/x-ads-api/creatives/reference#get-accounts/account_id/account_media) | `list_account_media` |
| GET | `/12/accounts/:account_id/account_media/:account_media_id` | `get_account_media` |
| DELETE | `/12/accounts/:account_id/account_media/:account_media_id` | `delete_account_media` |
| GET | [`/12/accounts/:account_id/media_creatives`](/x-ads-api/campaign-management/reference#get-accounts/account_id/media_creatives) | `list_media_creatives` |
| GET | [`/12/accounts/:account_id/media_creatives/:media_creative_id`](/x-ads-api/campaign-management/reference#get-accounts/account_id/media_creatives/media_creative_id) | `get_media_creative` |
| POST | [`/12/accounts/:account_id/media_creatives`](/x-ads-api/campaign-management/reference#post-accounts/account_id/media_creatives) | `create_media_creative` |
| DELETE | [`/12/accounts/:account_id/media_creatives/:media_creative_id`](/x-ads-api/campaign-management/reference#delete-accounts/account_id/media_creatives/media_creative_id) | `delete_media_creative` |
| GET | [`/12/accounts/:account_id/tweet_previews`](/x-ads-api/creatives/reference#get-accounts/account_id/tweet_previews) | `list_post_previews` |
| GET | `/12/accounts/:account_id/web_event_tags` | `list_web_event_tags` |
| GET | `/12/accounts/:account_id/web_event_tags/:web_event_tag_id` | `get_web_event_tag` |
| POST | `/12/accounts/:account_id/web_event_tags` | `create_web_event_tag` |
| PUT | `/12/accounts/:account_id/web_event_tags/:web_event_tag_id` | `update_web_event_tag` |
| DELETE | `/12/accounts/:account_id/web_event_tags/:web_event_tag_id` | `delete_web_event_tag` |
| GET | [`/12/accounts/:account_id/app_event_tags`](/x-ads-api/measurement/mobile-conversions#get-accounts/account_id/app_event_tags) | `list_app_event_tags` |
| GET | [`/12/accounts/:account_id/app_event_tags/:app_event_tag_id`](/x-ads-api/measurement/mobile-conversions#get-accounts/account_id/app_event_tags/app_event_tag_id) | `get_app_event_tag` |
| POST | `/12/accounts/:account_id/app_event_tags` | `create_app_event_tag` |
| DELETE | `/12/accounts/:account_id/app_event_tags/:app_event_tag_id` | `delete_app_event_tag` |
| GET | [`/12/accounts/:account_id/tracking_tags`](/x-ads-api/campaign-management/reference#get-accounts/account_id/tracking_tags) | `list_tracking_tags` |
| GET | [`/12/accounts/:account_id/tracking_tags/:tracking_tag_id`](/x-ads-api/campaign-management/reference#get-accounts/account_id/tracking_tags/tracking_tag_id) | `get_tracking_tag` |
| POST | [`/12/accounts/:account_id/tracking_tags`](/x-ads-api/campaign-management/reference#post-accounts/account_id/tracking_tags) | `create_tracking_tag` |
| PUT | [`/12/accounts/:account_id/tracking_tags/:tracking_tag_id`](/x-ads-api/campaign-management/reference#put-accounts/account_id/tracking_tags/tracking_tag_id) | `update_tracking_tag` |
| DELETE | [`/12/accounts/:account_id/tracking_tags/:tracking_tag_id`](/x-ads-api/campaign-management/reference#delete-accounts/account_id/tracking_tags/tracking_tag_id) | `delete_tracking_tag` |
| GET | `/12/accounts/:account_id/app_lists` | `list_app_lists` |
| GET | `/12/accounts/:account_id/app_lists/:app_list_id` | `get_app_list` |
| POST | `/12/accounts/:account_id/app_lists` | `create_app_list` |
| DELETE | `/12/accounts/:account_id/app_lists/:app_list_id` | `delete_app_list` |
| POST | [`/12/accounts/:account_id/campaigns`](/x-ads-api/campaign-management/reference#post-accounts/account_id/campaigns) | `create_campaign` |
| PUT | [`/12/accounts/:account_id/campaigns/:campaign_id`](/x-ads-api/campaign-management/reference#put-accounts/account_id/campaigns/campaign_id) | `update_campaign` |
| PUT | `/12/accounts/:account_id/campaigns/:campaign_id/activate` | `activate_campaign` |
| POST | [`/12/accounts/:account_id/line_items`](/x-ads-api/campaign-management/reference#post-accounts/account_id/line_items) | `create_line_item` |
| PUT | [`/12/accounts/:account_id/line_items/:line_item_id`](/x-ads-api/campaign-management/reference#put-accounts/account_id/line_items/line_item_id) | `update_line_item` |
| PUT | `/12/accounts/:account_id/line_items/:line_item_id/activate` | `activate_line_item` |
| POST | [`/12/accounts/:account_id/targeting_criteria`](/x-ads-api/campaign-management/reference#post-accounts/account_id/targeting_criteria) | `add_targeting_criterion` |
| DELETE | [`/12/accounts/:account_id/targeting_criteria/:targeting_criterion_id`](/x-ads-api/campaign-management/reference#delete-accounts/account_id/targeting_criteria/targeting_criterion_id) | `remove_targeting` |
| POST | [`/12/accounts/:account_id/tweet`](/x-ads-api/creatives/reference#post-accounts/account_id/tweet) | `create_ad_post` |
| POST | [`/12/accounts/:account_id/promoted_tweets`](/x-ads-api/campaign-management/reference#post-accounts/account_id/promoted_tweets) | `promote_post` |