x-ads-mcp-server

# X Ads MCP Server (Twitter Ads) by Insightful Pipe

[![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-blue)](https://insightfulpipe.com/mcp-servers/x-ads)
[![Insightful Pipe](https://img.shields.io/badge/Insightful_Pipe-MCP_Servers-purple)](https://insightfulpipe.com/mcp-servers)
[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)

> **Connect X Ads (formerly Twitter Ads) to AI assistants to report on campaigns and build them: campaigns, line items, promoted-only posts and cards, with new campaigns starting paused.**

Part of the [Insightful Pipe MCP Server Collection](https://insightfulpipe.com/mcp-servers) — The X Ads MCP server gives Claude, ChatGPT, Cursor and other AI assistants 80 actions (52 read and 28 that make changes) on your X ad accounts. Your assistant can report on campaigns, line items, promoted posts and creatives, then create campaigns, line items, promoted-only ad posts and website, app or carousel cards. New campaigns and line items start paused, ad posts are created promoted-only so they don't appear on your public timeline, and delete actions stay off until an admin turns them on.

For your account's own posts, replies, direct messages and post analytics, use the [X Organic MCP server](https://github.com/Insightful-Pipe/x-organic-mcp-server).

[![Explore All MCP Servers](https://img.shields.io/badge/Explore_All-MCP_Servers-blue?style=for-the-badge)](https://insightfulpipe.com/mcp-servers)

![X Ads MCP Server](https://insightfulpipe.com/images/x-social-media-black-icon.svg)

## MCP Server URL

```
https://x-ads.insightfulmcp.com/
```

## What is X Ads MCP?

X Ads MCP is a **remote Model Context Protocol server** that connects your X Ads Manager to AI assistants. This real-time advertising integration allows you to:

- Query X ad performance using natural language
- Analyze promoted tweet engagement
- Track video views and website conversions
- Create async analytics jobs for large datasets
- Get AI recommendations for campaign optimization

## Installation

### Claude

1. Copy the MCP Server URL: `https://x-ads.insightfulmcp.com/`
2. Open [Claude connector settings](https://claude.ai/settings/connectors) (**Customize > Connectors**), click **+** and then **Add custom connector**
3. Paste the URL and click **Add**
4. Click **Connect** and sign in to InsightfulPipe if asked. Claude then lists the connector as connected.

### ChatGPT

Custom MCP servers are added through ChatGPT's **Developer mode**. Availability depends on your ChatGPT plan, and workspace admins may need to allow it.

1. Turn on **Developer mode** in ChatGPT settings
2. Create a new app for a remote MCP server and paste the URL: `https://x-ads.insightfulmcp.com/`
3. Sign in to InsightfulPipe if asked. The connection finishes as soon as you are signed in.

See OpenAI's guide: [Developer mode and MCP apps in ChatGPT](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt)

### Claude Code

```bash
claude mcp add --transport http x-ads https://x-ads.insightfulmcp.com/
```

### Cursor

Add the server to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (one project):

```json
{
  "mcpServers": {
    "x-ads": {
      "url": "https://x-ads.insightfulmcp.com/"
    }
  }
}
```

When Cursor shows **Needs authentication**, click **Connect** and sign in to InsightfulPipe if asked.

## Available Actions

80 actions: 52 read and 28 that make changes, 11 of them destructive and off by default.

### Read Actions (52)

<details>
<summary>Show all 52 read actions</summary>

| Action | Description |
|--------|-------------|
| `create_async_job` | Create an async analytics job |
| `get_account` | Get details for a specific ad account |
| `get_account_history` | Retrieve a summary of changes made to a specific entity on the account |
| `get_account_media` | List account media assets associated with the current account |
| `get_account_media_item` | Get details for a specific account media object |
| `get_active_entities` | Get active entities (campaigns, line items, etc.) that had activity in a time range |
| `get_advertiser_business_categories` | Retrieve valid advertiser business categories for line items |
| `get_async_jobs` | Retrieve details for async analytics jobs |
| `get_authenticated_user_access` | Retrieve the permissions of the authenticated user for the current account |
| `get_campaign` | Get details for a specific campaign |
| `get_campaigns` | List all campaigns for an ad account |
| `get_card` | Get details for a specific card |
| `get_cards` | List cards associated with the current account |
| `get_content_categories` | Retrieve content categories for preroll video targeting |
| `get_features` | Retrieve features enabled for the current account |
| `get_funding_instrument` | Get details for a specific funding instrument |
| `get_funding_instruments` | List all funding instruments for an ad account |
| `get_iab_categories` | Retrieve IAB content categories |
| `get_line_item` | Get details for a specific line item |
| `get_line_items` | List all line items for an ad account |
| `get_media_creative` | Get details for a specific media creative |
| `get_media_creatives` | List all media creatives for an ad account |
| `get_media_library` | List media library objects associated with the current account |
| `get_media_library_item` | Get details for a specific media library object |
| `get_promotable_user` | Get details for a specific promotable user |
| `get_promotable_users` | List promotable users associated with the current account |
| `get_promoted_account` | Get details for a specific promoted account |
| `get_promoted_accounts` | List promoted accounts associated with line items under the current account |
| `get_promoted_tweet` | Get details for a specific promoted tweet |
| `get_promoted_tweets` | List promoted tweets associated with line items under the current account |
| `get_recommendations` | Retrieve campaign optimization recommendations for the account |
| `get_scheduled_promoted_tweet` | Get details for a specific scheduled promoted tweet |
| `get_scheduled_promoted_tweets` | List scheduled promoted tweets associated with the current account |
| `get_stats` | Retrieve synchronous analytics for an ad account |
| `get_targeting_app_store_categories` | Discover available app store category-based targeting criteria |
| `get_targeting_conversations` | Discover available conversation-based targeting criteria |
| `get_targeting_criteria` | List targeting criteria associated with line items under the current account |
| `get_targeting_criterion` | Get details for a specific targeting criterion |
| `get_targeting_devices` | Discover available device-based targeting criteria |
| `get_targeting_events` | Discover available event-based targeting criteria |
| `get_targeting_interests` | Discover available interest-based targeting criteria |
| `get_targeting_languages` | Discover available language targeting criteria |
| `get_targeting_locations` | Discover available location-based targeting criteria (countries, regions, cities, postal codes, metros) |
| `get_targeting_network_operators` | Discover available network operator (carrier) targeting criteria |
| `get_targeting_platform_versions` | Discover available mobile OS version-based targeting criteria |
| `get_targeting_platforms` | Discover available platform-based targeting criteria (iOS, Android, etc.) |
| `get_targeting_suggestions` | Get keyword or user targeting suggestions to complement your targeting selection |
| `get_targeting_tv_markets` | Discover available TV markets where TV shows can be targeted |
| `get_targeting_tv_shows` | Discover available TV show-based targeting criteria |
| `get_tax_settings` | Retrieve tax setting details for the current account |
| `get_tracking_tag` | Get details for a specific tracking tag |
| `get_tracking_tags` | List tracking tags associated with the current account |

</details>

### Actions That Make Changes (28)

<details>
<summary>Show all 28 write and destructive actions</summary>

| Action | Description |
|--------|-------------|
| `cancel_async_job` | Cancel a PROCESSING async analytics job |
| `create_ad_tweet` | Create a promoted-only (nullcast) tweet for use in ad campaigns |
| `create_campaign` | Create a new campaign (created in PAUSED status for safety) |
| `create_card` | Create a card (website, app, or carousel) for use in tweets |
| `create_line_item` | Create a new line item (ad group) under a campaign (created in PAUSED status for safety) |
| `create_media_creative` | Create a media creative and associate it with a line item |
| `create_media_library_item` | Add a media asset to the account media library |
| `create_promoted_account` | Associate a user account with a line item as a promoted account |
| `create_promoted_tweet` | Associate tweets with a line item as promoted tweets |
| `create_scheduled_promoted_tweet` | Associate a scheduled tweet with a line item as a scheduled promoted tweet |
| `create_scheduled_tweet` | Create a scheduled tweet for future publishing |
| `create_targeting_criterion` | Create a targeting criterion for a line item |
| `create_tracking_tag` | Create a tracking tag for a line item |
| `delete_campaign` | Delete a campaign |
| `delete_card` | Delete a card |
| `delete_line_item` | Delete a line item |
| `delete_media_creative` | Delete a media creative |
| `delete_promoted_account` | Remove a promoted account association |
| `delete_promoted_tweet` | Remove a promoted tweet association |
| `delete_scheduled_promoted_tweet` | Remove a scheduled promoted tweet association |
| `delete_scheduled_tweet` | Delete a scheduled tweet |
| `delete_targeting_criterion` | Delete a targeting criterion |
| `delete_tracking_tag` | Delete a tracking tag |
| `update_campaign` | Update an existing campaign |
| `update_line_item` | Update an existing line item |
| `update_media_library_item` | Update a media library object's metada