> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/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 23 tools are backed by the following Ads API endpoints (23 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/funding_instruments`](/x-ads-api/campaign-management/reference#get-accounts/account_id/funding_instruments)                                                 | `list_funding_instruments`   |
| 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/targeting_criteria`](/x-ads-api/campaign-management/reference#get-accounts/account_id/targeting_criteria)                                                   | `list_targeting_criteria`    |
| 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`](/x-ads-api/analytics#get-stats/accounts/account_id)                                                                                                 | `get_account_stats`          |
| 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/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` |
| 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`               |