# X Ads

> X Ads is a freemium MCP server for marketing and seo. Read X ad campaigns and stage preview-first changes from your AI assistant. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $39 a month
- **Platforms:** Web, API, CLI
- **Website:** https://www.getmcpads.com/tools/x-ads
- **Repository:** https://github.com/get-mcp-ads/x-ads-mcp-server
- **MCP Registry name:** com.getmcpads/x-ads
- **Categories:** marketing and SEO
- **Listing updated:** 2026-11-14

## About

The X Ads server is built around X's own Ads MCP endpoint at ads-api.x.com. The hosted Get MCP Ads version relays it with the token from your X sign-in, then adds account selection, previews before each change, media uploads, alerts and Google Sheets. You tick which ad accounts to share and the assistant sees only those.

Reads cover campaigns, ad groups and promoted posts, with account statistics (75 metrics) and reach and average frequency. Writes include budgets, schedules, frequency caps and targeting, and new campaigns and ad groups are created paused. Website cards take one image or video, or a carousel of 2 to 6, with a single destination. A new campaign needs a funding source on the X account.

The open-source npm package (25 read tools, 21 writes) runs locally over stdio with your own OAuth 2.0 user token. `X_ADS_ACCOUNT_IDS` is required even for reads, and writes stay off unless `X_ADS_ENABLE_WRITES=true`, with each call previewing until confirmed.

## Features

- **Account allowlist:** Requires explicit ad account IDs, even for read calls.
- **Reach and frequency:** Reports reach and average frequency by campaign, ad group and promoted post.
- **Preview before change:** Write calls preview first and apply only when confirmed.
- **Paused creation:** New campaigns and ad groups start paused.
- **Website cards:** Builds cards from one image or video, or a 2-6 item carousel.
- **Writes off by default:** 21 write tools appear only when enabled.

## Good for

- Pull spend and clicks by campaign for the last week
- Check which targeting an ad group uses
- Raise a daily budget and cap frequency after a preview
- Upload a video and promote it as a website card
- Check reach for a seasonal campaign

## Install

### Claude Code (Terminal)

```sh
claude mcp add x-ads --env X_ADS_ACCESS_TOKEN='<X_ADS_ACCESS_TOKEN>' --env X_ADS_ACCOUNT_IDS='<X_ADS_ACCOUNT_IDS>' -- npx -y @getmcpads/x-ads-mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "x-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/x-ads-mcp-server"
      ],
      "env": {
        "X_ADS_ACCESS_TOKEN": "<X_ADS_ACCESS_TOKEN>",
        "X_ADS_ACCOUNT_IDS": "<X_ADS_ACCOUNT_IDS>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "x-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/x-ads-mcp-server"
      ],
      "env": {
        "X_ADS_ACCESS_TOKEN": "<X_ADS_ACCESS_TOKEN>",
        "X_ADS_ACCOUNT_IDS": "<X_ADS_ACCOUNT_IDS>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "x-ads": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/x-ads-mcp-server"
      ],
      "env": {
        "X_ADS_ACCESS_TOKEN": "<X_ADS_ACCESS_TOKEN>",
        "X_ADS_ACCOUNT_IDS": "<X_ADS_ACCOUNT_IDS>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "x-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/x-ads-mcp-server"
      ],
      "env": {
        "X_ADS_ACCESS_TOKEN": "<X_ADS_ACCESS_TOKEN>",
        "X_ADS_ACCOUNT_IDS": "<X_ADS_ACCOUNT_IDS>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "x-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/x-ads-mcp-server"
      ],
      "env": {
        "X_ADS_ACCESS_TOKEN": "<X_ADS_ACCESS_TOKEN>",
        "X_ADS_ACCOUNT_IDS": "<X_ADS_ACCOUNT_IDS>"
      }
    }
  }
}
```

## Tools

- `x_ads_list_campaigns`: Lists X campaigns for the selected ad accounts.
- `x_ads_get_account_stats`: Returns account statistics by campaign, ad group and promoted post.
- `x_ads_get_campaign_reach`: Returns reach and average frequency for a campaign.
- `x_ads_list_targeting_criteria`: Lists targeting set on an ad group.
- `x_ads_update_line_item`: Updates an ad group's budget, schedule or frequency cap after preview.
- `x_ads_create_campaign`: Creates a paused campaign.
- `x_ads_create_line_item`: Creates a paused ad group.
- `x_ads_add_targeting_criterion`: Adds a targeting criterion to an ad group.
- `x_ads_upload_media`: Uploads media through X's media API.
- `x_ads_create_card`: Creates a website card.
- `x_ads_create_ad_post`: Creates an ad post.
- `x_ads_promote_post`: Promotes a post.

## FAQ

### Does it need an app-only token?

No; the README says an app-only bearer token is not sufficient and a user OAuth 2.0 token is needed.

### Can it change my campaigns by default?

No. Writes are disabled until `X_ADS_ENABLE_WRITES` is true, and calls preview unless confirm is true.

### What Node version is required?

Node.js 22.23.4, 24.22.1, 26.12.1 or newer.

### Is there a free hosted tier?

Yes, one ad account and 200 requests a month with no card.

### Is X Ads free?

X Ads has a free plan, with paid plans for more usage or features. Paid plans start at $39 a month.

### How do I add X Ads to Claude Code?

Run this command in your terminal: claude mcp add x-ads --env X_ADS_ACCESS_TOKEN='<X_ADS_ACCESS_TOKEN>' --env X_ADS_ACCOUNT_IDS='<X_ADS_ACCOUNT_IDS>' -- npx -y @getmcpads/x-ads-mcp-server

### What are the best alternatives to X Ads?

The closest alternatives to X Ads are Google Ads + Meta Ads + SEO/GEO MCP, Calven, MCP, Red Center Studio free tools and ASOScan.

## Alternatives

- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [Red Center Studio free tools](https://ai-powered.com/mcp/red-center-studio-free-tools): Red Center Studio free tools is a free MCP server for marketing and seo.
- [ASOScan](https://ai-powered.com/mcp/asoscan): ASOScan is an MCP server for marketing and seo.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [Fifty Asks](https://ai-powered.com/mcp/fifty-asks): Fifty Asks is a free MCP server for maps and travel.
- [Daniels AI Design Studio](https://ai-powered.com/mcp/daniels-ai-design-studio): Daniels AI Design Studio is an MCP server for design and media.

---
Source: https://ai-powered.com/mcp/x-ads
