# X Ads

> Every X Ads tool the MCP server exposes, with its parameters. 26 tools, 0 metrics and 0 dimensions, on a dedicated endpoint.

[Documentation](https://www.getmcpads.com/docs) / [Sources](https://www.getmcpads.com/docs/sources)

Campaigns, ad groups, promoted posts, targeting and native performance via X’s official MCP.

Connection

|  |  |
| --- | --- |
| Platform id | `x_ads` |
| Tool prefix | `x_ads_` |
| Account parameter | `account_id` |
| Dedicated endpoint | https://mcp.getmcpads.com/x-ads/mcp |
| Access | Available for authorized, selected accounts. |
| Tools | 26, 10 of which write |
| Metrics | 0 |
| Dimensions | 0 |

## Scope requested

| Scope | Grants | Allows writes |
| --- | --- | --- |
| `ads.read` | Read authorized X Ads accounts, campaigns, creatives, targeting and performance. | No |
| `ads.write` | Create and manage X Ads campaigns, ad groups, targeting and promoted posts. | Yes |
| `offline.access` | Renew the X authorization without another sign-in. | No |

> **Note** What the gateway can change here: Create campaigns and ad groups in pause. Update budgets on ad groups, pause or activate delivery, manage targeting and promoted posts. Every change previews first and requires confirmation.

## Catalogues

- [Metrics](https://www.getmcpads.com/docs/sources/x-ads/metrics): 0 metrics, with the field name each one maps to.
- [Dimensions](https://www.getmcpads.com/docs/sources/x-ads/dimensions): 0 dimensions, with their constraints.

## Write tools (10)

Absent from the tool list on the Free plan. Each one previews by default and needs a second call with `confirm: true`.

| Tool | What it does | Kind | Discovery |
| --- | --- | --- | --- |
| [`x_ads_activate_campaign`](https://www.getmcpads.com/docs/sources/x-ads/tools/x_ads_activate_campaign) | Activate a campaign (set entity_status=ACTIVE). | Write | On demand |
| [`x_ads_activate_line_item`](https://www.getmcpads.com/docs/sources/x-ads/tools/x_ads_activate_line_item) | Activate a line item (set entity_status=ACTIVE). | Write | On demand |
| [`x_ads_add_targeting_criterion`](https://www.getmcpads.com/docs/sources/x-ads/tools/x_ads_add_targeting_criterion) | Add one targeting criterion to a line item (call once per criterion). | Write | On demand |
| [`x_ads_create_ad_post`](https://www.getmcpads.com/docs/sources/x-ads/tools/x_ads_create_ad_post) | Compose a promoted-only ("nullcasted") post to use as an ad creative. | Write | On demand |
| [`x_ads_create_campaign`](https://www.getmcpads.com/docs/sources/x-ads/tools/x_ads_create_campaign) | Create a campaign in an ads account. | Write | On demand |
| [`x_ads_create_line_item`](https://www.getmcpads.com/docs/sources/x-ads/tools/x_ads_create_line_item) | Create a line item (ad group) under a campaign. | Write | On demand |
| [`x_ads_promote_post`](https://www.getmcpads.com/docs/sources/x-ads/tools/x_ads_promote_post) | Attach post(s) to a line item as its ad creative(s). | Write | On demand |
| [`x_ads_remove_targeting`](https://www.getmcpads.com/docs/sources/x-ads/tools/x_ads_remove_targeting) | Remove a targeting criterion from its line item (undo a targeting mistake). | Write | On demand |
| [`x_ads_update_campaign`](https://www.getmcpads.com/docs/sources/x-ads/tools/x_ads_update_campaign) | Rename a campaign or pause it (entity_status=PAUSED). | Write | On demand |
| [`x_ads_update_line_item`](https://www.getmcpads.com/docs/sources/x-ads/tools/x_ads_update_line_item) | 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. | Write | On demand |

## Read tools (16)

Tools marked *Announced* appear in your client's tool list. The rest are reachable through `search_tools` and `run_tool`, which run the same checks.

| Tool | What it does | Kind | Discovery |
| --- | --- | --- | --- |
| [`x_ads_get_account_stats`](https://www.getmcpads.com/docs/sources/x-ads/tools/x_ads_get_account_stats) | 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. | Read | On demand |
| [`x_ads_get_active_entities`](https://www.getmcpads.com/docs/sources/x-ads/tools/x_ads_get_active_entities) | 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. | Read | On demand |
| [`x_ads_get_campaign`](https://www.getmcpads.com/docs/sources/x-ads/tools/x_ads_get_campaign) | Get a single campaign by ID Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency. | Read | On demand |
| [`x_ads_get_campaign_reach`](https://www.getmcpads.com/docs/sources/x-ads/tools/x_ads_get_campaign_reach) | 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. | Read | On demand |
| [`x_ads_get_line_item`](https://www.getmcpads.com/docs/sources/x-ads/tools/x_ads_get_line_item) | 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. | Read | On demand |
| [`x_ads_list_account_posts`](https://www.getmcpads.com/docs/sources/x-ads/tools/x_ads_list_account_posts) | 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. | Read | On demand |
| [`x_ads_list_ads_accounts`](https://www.getmcpads.com/docs/sources/x-ads/tools/x_ads_list_ads_accounts) | 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. | Read | Announced |
| [`x_ads_list_campaigns`](https://www.getmcpads.com/docs/sources/x-ads/tools/x_ads_list_campaigns) | List campaigns for an account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency. | Read | On demand |
| [`x_ads_list_funding_instruments`](https://www.getmcpads.com/docs/sources/x-ads/tools/x_ads_list_funding_instruments) | 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. | Read | On demand |
| [`x_ads_list_line_item_placements`](https://www.getmcpads.com/docs/sources/x-ads/tools/x_ads_list_line_item_placements) | 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. | Read | On demand |
| [`x_ads_list_line_items`](https://www.getmcpads.com/docs/sources/x-ads/tools/x_ads_list_line_items) | 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. | Read | On demand |
| [`x_ads_list_promoted_posts`](https://www.getmcpads.com/docs/sources/x-ads/tools/x_ads_list_promoted_posts) | 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. | Read | On demand |
| [`x_ads_list_targeting_criteria`](https://www.getmcpads.com/docs/sources/x-ads/tools/x_ads_list_targeting_criteria) | 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. | Read | On demand |
| [`x_ads_list_web_event_tags`](https://www.getmcpads.com/docs/sources/x-ads/tools/x_ads_list_web_event_tags) | 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. | Read | On demand |
| [`x_ads_search_targeting_interests`](https://www.getmcpads.com/docs/sources/x-ads/tools/x_ads_search_targeting_interests) | Search targetable interest categories by name. | Read | On demand |
| [`x_ads_search_targeting_locations`](https://www.getmcpads.com/docs/sources/x-ads/tools/x_ads_search_targeting_locations) | Search targetable locations by name. | Read | On demand |

## MCP resources

Read these with `resources/read` for machine readable metadata about the source.

| Name | URI |
| --- | --- |
| X Ads reporting and writes | `x-ads://guide` |

---

This page as HTML: https://www.getmcpads.com/docs/sources/x-ads
Every page under /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.