X Ads

Name: X Ads
Author: get-mcp-ads

作者：get-mcp-ads版本 1.1.1i★ –i在你的电脑上运行

注册名称com.getmcpads/x-ads

安装

概览

作者提供的说明（英文原文）

X Ads MCP server: 25 read tools, 21 opt-in preview-first writes.

PopNx MCP 的三大支柱

这三项永远不会合并成一个分数：意见、测量和人气是不同的东西。

用户评价i暂无评价评价功能将在后续阶段与账户功能一起开放
我们的基础检查i1 项中通过 1 项依据公开信息检查；尚未扫描代码
使用情况i尚未统计★ –

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

连接方式: 在你的电脑上运行
传输方式: stdio
分类: 营销与社交媒体
你需要填写：X_ADS_ACCESS_TOKEN, X_ADS_ACCOUNT_IDS

安装

选择你使用的 AI 应用，然后复制设置。

安装之前

基础检查：1 项中通过 1 项
在你的电脑上运行，拥有你的用户账户的权限（文件、网络、应用）。
需要你自己填写： X_ADS_ACCESS_TOKEN, X_ADS_ACCOUNT_IDS, X_ADS_SCOPES, X_ADS_ENABLE_WRITES

标为机密的值是你账户的钥匙。千万不要分享给别人，也不要粘贴到聊天里。

你需要

npm已安装 Node.js（用于 npx 命令）

你用的是哪个应用？

ClaudeClaude CodeCursorVS CodeChatGPT

在上方选择你的应用。我们会记住它，下次按钮会显示“安装到 …”。

打开 Claude Desktop → Settings → Developer → Edit Config，把下面的内容粘贴到 claude_desktop_config.json

{
  "mcpServers": {
    "x-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/x-ads-mcp-server"
      ],
      "env": {
        "X_ADS_ACCESS_TOKEN": "your-value",
        "X_ADS_ACCOUNT_IDS": "your-value",
        "X_ADS_SCOPES": "your-value",
        "X_ADS_ENABLE_WRITES": "your-value"
      }
    }
  }
}

在终端中运行这条命令

claude mcp add x-ads --env X_ADS_ACCESS_TOKEN=your-value --env X_ADS_ACCOUNT_IDS=your-value --env X_ADS_SCOPES=your-value --env X_ADS_ENABLE_WRITES=your-value -- npx -y @getmcpads/x-ads-mcp-server

运行前请先填写空着的值。

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json，或 ~/.cursor/mcp.json

{
  "mcpServers": {
    "x-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/x-ads-mcp-server"
      ],
      "env": {
        "X_ADS_ACCESS_TOKEN": "your-value",
        "X_ADS_ACCOUNT_IDS": "your-value",
        "X_ADS_SCOPES": "your-value",
        "X_ADS_ENABLE_WRITES": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "servers": {
    "x-ads": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/x-ads-mcp-server"
      ],
      "env": {
        "X_ADS_ACCESS_TOKEN": "your-value",
        "X_ADS_ACCOUNT_IDS": "your-value",
        "X_ADS_SCOPES": "your-value",
        "X_ADS_ENABLE_WRITES": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

这个服务器在你的电脑上运行，而 ChatGPT 只能连接互联网上的服务器。请选择其他应用。

你的选择通过 Cookie 保存在这台设备上，无需账户。

需要你填写的值

X_ADS_ACCESS_TOKEN 机密必填 env
User OAuth 2.0 token. Keep it secret.
X_ADS_ACCOUNT_IDS 必填 env
Comma-separated allowed account IDs. Required even for reads.
X_ADS_SCOPES env
Scopes actually granted to the token, including ads.read.
X_ADS_ENABLE_WRITES env
true exposes 21 write tools. Defaults to false. Calls preview unless confirm is true.

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同，请以 README 为准。

它能做什么

它在你的电脑上运行；安装后，工具列表会显示在你的 AI 应用中。

基础检查i

我们检查的是任何人都能看到的信息；我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月7日

✓ 通过
作者与仓库一致
注册名称已通过域名 getmcpads.com 验证（注册中心会核实域名所有权）
… 尚未检查
仍在维护
我们还没有从 GitHub 读取这个仓库
… 尚未检查
有许可证
我们还没有从 GitHub 读取这个仓库
– 不适用
端点有响应
它在你的电脑上运行，没有互联网端点
– 不适用
使用 OAuth 登录
在你的电脑上运行，改用本地设置
… 尚未检查
工具描述中没有隐藏指令
它在你的电脑上运行；我们只能读取互联网端点的工具列表

与“营销与社交媒体”中的其他服务器比较i

星标数多于此分类中其他 2985 个服务器的 0%
发布到注册中心的时间比此分类中其他 2985 个服务器的 74% 更新
基础检查结果等于或优于此分类中其他 2985 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时，星标数才计入。

常见问题

X Ads 安全吗？

它在 1 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前，请先看看这个服务器要求哪些权限，并使用只具备所需权限的密钥。

它需要哪些密钥或代码？

你需要填写：X_ADS_ACCESS_TOKEN, X_ADS_ACCOUNT_IDS

它在我的电脑上运行还是在云端？

它在你的电脑上运行。你的 AI 应用会在需要时启动它，数据不会经过作者的服务器（除非它自己调用在线服务）。

它还在维护吗？

GitHub 仓库最后更新于–，最新版本（1.1.1）于12天前进入注册中心。

哪些应用可以使用它？

支持 MCP 的应用，例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Node.js。

有什么可以替代它？

同一分类中有：MCP YouTube Transcript, Google Analytics MCP, BibiGPT YouTube Video Summarizer

替代选择

同一分类中其他作者的服务器，按星标数排序。

如何看卡片：★ GitHub 星标i三大支柱：评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

MCP YouTube Transcript

作者：jkawamoto

An MCP server retrieving transcripts of YouTube videos

在你的电脑上运行★ 495MIT10天前更新

安装

Google Analytics MCP

作者：surendranb

GA4 MCP server for AI agents: schema discovery, server-side aggregation, analysis-ready defaults.

在你的电脑上运行★ 244MIT10天前更新

安装

BibiGPT YouTube Video Summarizer

作者：JimmyLv

AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.

在云端运行★ 137MIT10天前更新

安装

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

X Ads MCP server

Bring your X Ads accounts into your MCP client.

Read campaigns and performance, inspect targeting and prepare changes for explicitly selected accounts.

Watch the film · What's new · Install · Tool reference · Try hosted getmcpads

[Play the 45-second film](https://www.getmcpads.com/home/film/get-mcp-ads-brand-film-1080p.mp4)

The film shows hosted getmcpads with sample data. Its MCP Apps, from creative galleries and alerts to Google Sheets exports and bulk launches, belong to the hosted product. This repository provides the standalone native API tools.

25 read tools · 21 write tools, disabled by default.

Run locally with your own platform credentials and a client that supports stdio MCP, such as Claude Desktop, Claude Code or Cursor. Your requests go directly to the platform. For managed connections, including supported ChatGPT setups, use the hosted option.

What's new

[v1.1.1: Zod 4 security update](https://github.com/get-mcp-ads/x-ads-mcp-server/releases/tag/v1.1.1) · October 26, 2026

Update zod to 4.6.7. Every Zod release before 4.6.6 is covered by the high-severity advisory GHSA-mrhx-c7xc-m3w5: validating an oversized constrained collection can exhaust memory, and no Zod 3 release carries the fix. npm audit --omit=dev reports no vulnerability again.
Keep the Zod 3 validation behaviour. A parameter default is still validated and completed before use, so an omitted object must still supply its required fields.
Keep each parameter's own description when the parameter is optional or has a default. Zod 4 stores a description on the wrapped schema only, so the shared fallback description could otherwise replace it.
Tool names, parameters and descriptions published over MCP are unchanged. server-card.json is regenerated with Zod 4's JSON Schema output, which spells some constraints differently.

Earlier releases

Version	Date	Highlights
1.1.0	October 23, 2026	Campaign and line item rename
1.0.1	September 23, 2026	Public repository restored
1.0.0	September 20, 2026	First standalone release

Full changelog · All releases

Source synchronization: SOURCE_SYNC.md.

Upgrade notes

Requires Node.js 22.23.4, 24.22.1, 26.12.1 or a newer release. These carry the October 2026 security fixes, and the server prints a warning on stderr when it runs on an older one. CI covers Node 22, 24 and 26.

No breaking change. Configuration variables and accepted values are unchanged: X_ADS_ACCOUNT_IDS stays required and only true enables writes, as in 1.0. The rename tools are writes: they appear only with X_ADS_ENABLE_WRITES=true and need ads.write in X_ADS_SCOPES.

Read the current tool schemas before reusing saved arguments. Writes remain optional and require explicit confirmation. Hosted creative integrations and MCP Apps UI are outside this release.

Install this release

This is a GitHub source release. npm and MCP Registry versions are published separately. The commands below select this exact version.

git clone --branch v1.1.1 --depth 1 https://github.com/get-mcp-ads/x-ads-mcp-server.git

cd x-ads-mcp-server npm ci npm run build

Configure your MCP client to run node with the absolute path to dist/cli.js and the platform credentials documented below.

Prefer a managed connection? Use X Ads with hosted getmcpads. Connect your account, select the data your assistant may access and use the hosted MCP connection. See the site for current features and plans.

Configuration

Provide these environment variables through the client's secret configuration:

Variable	Purpose
`X_ADS_ACCESS_TOKEN`	Your user OAuth 2.0 access token. An app-only bearer token is not sufficient.
`X_ADS_ACCOUNT_IDS`	Required comma-separated account IDs, restricted to accounts the token may access.
`X_ADS_SCOPES`	Scopes actually granted to the token. Defaults to `ads.read`.
`X_ADS_ENABLE_WRITES`	Defaults to `false`. Only the exact value `true` exposes writes.

Obtain your token and Ads Project access using X's official setup guide. Use ads.read for reporting, ads.write for campaign changes and media.write for uploads and media-library writes. Setting X_ADS_SCOPES does not grant permissions. This package accepts a token; it does not run an OAuth browser flow or persist rotating refresh tokens. When the token expires, renew it securely and restart the server.

Safety and coverage

Writes preview by default. Review the exact account, target and parameters before repeating the call with confirm: true. Campaigns and line items are created paused. Activation can spend advertising budget. Media uploads can consume X API credits and are limited to 4 MB. Do not retry a write automatically when its result is uncertain. Read the account and reconcile it first. Selected-account checks apply before dispatch and filter account discovery responses. Unknown arguments are rejected. Native pagination, attribution and monetary _micro fields are preserved. A micro unit is one millionth of the account currency.

This server exposes a reviewed subset of the official API. It does not automatically expose new upstream tools. Native media reads and writes are included. Hosted creative galleries, visual editors and MCP Apps UI are excluded. Use tools/list or server-card.json for exact schemas and the official API reference for provider details.

Hosted option

getmcpads for X Ads manages the hosted connection and account selection. Hosted and source releases can differ. Contact: hello@getmcpads.com.

Development

npm run typecheck

npm run lint npm run build npm test npm run catalog

All tests run offline with synthetic responses. No live account is changed.

Tools

Every tool is listed below. See server-card.json for complete parameter and output schemas.

25 read tools

Tool	Purpose
`x_ads_list_ads_accounts`	List the ads accounts the authenticated user can access
`x_ads_list_campaigns`	List campaigns for an account
`x_ads_get_campaign`	Get a single campaign by ID
`x_ads_list_funding_instruments`	List funding instruments (payment sources) for an ads account
`x_ads_list_line_items`	List line items (ad groups) for an ads account
`x_ads_get_line_item`	Get a single line item by ID
`x_ads_list_promoted_posts`	List promoted posts (promoted tweets) for an ads account
`x_ads_list_targeting_criteria`	List targeting criteria for an ads account's line items
`x_ads_list_account_posts`	List posts (tweets) usable for promotion by an ads account
`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
`x_ads_list_line_item_placements`	List valid placement combinations per line item product type
`x_ads_get_account_stats`	Get synchronous analytics (impressions, engagements, spend) for an ads account
`x_ads_get_active_entities`	List which ads entities had metrics change in a time window (use before requesting account stats)
`x_ads_get_campaign_reach`	Get reach and average-frequency metrics for campaigns
`x_ads_search_targeting_interests`	Search targetable interest categories by name.
`x_ads_search_targeting_locations`	Search targetable locations by name.
`x_ads_list_cards`	List the cards in an ads account
`x_ads_get_card`	Get a single card by ID
`x_ads_list_media_library`	List the media library objects in an ads account
`x_ads_get_media_library_item`	Get a single media library object by media key
`x_ads_get_promoted_post`	Get a single promoted post by ID
`x_ads_get_targeting_criterion`	Get a single targeting criterion by ID
`x_ads_list_post_previews`	Get rendered HTML previews for published or scheduled posts
`x_ads_get_web_event_tag`	Get a single website conversion event tag by ID
`x_ads_get_media_upload_status`	Read processing status of an upload owned by the connected X user.

21 write tools

Disabled by default. Calls preview unless explicitly confirmed. Check the configuration and exact schema before use.

Tool	Purpose
`x_ads_create_campaign`	Create a campaign in an ads account.
`x_ads_update_campaign`	Rename a campaign or pause it (entity_status=PAUSED).
`x_ads_activate_campaign`	Activate a campaign (set entity_status=ACTIVE).
`x_ads_create_line_item`	Create a line item (ad group) under a campaign.
`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.
`x_ads_activate_line_item`	Activate a line item (set entity_status=ACTIVE).
`x_ads_promote_post`	Attach post(s) to a line item as its ad creative(s).
`x_ads_add_targeting_criterion`	Add one targeting criterion to a line item (call once per criterion).
`x_ads_remove_targeting`	Remove a targeting criterion from its line item (undo a targeting mistake).
`x_ads_create_ad_post`	Compose a promoted-only ("nullcasted") post to use as an ad creative.
`x_ads_create_card`	Create a card from a JSON components payload.
`x_ads_delete_card`	Delete a card from an ads account.
`x_ads_create_media_library_item`	Register an existing media key as a named item in the account's media library.
`x_ads_delete_media_library_item`	Delete a media library object from an ads account Preview by default.
`x_ads_update_media_library_item`	Update a media library object's metadata (e.g. name, title, description) Preview by default.
`x_ads_create_web_event_tag`	Create a website conversion event tag (pixel); the returned id can be set as a line item's primary_web_event_tag Preview by default.
`x_ads_delete_web_event_tag`	Delete a website conversion event tag Preview by default.
`x_ads_update_web_event_tag`	Update a website conversion event tag Preview by default.
`x_ads_upload_media`	Upload an image, GIF or MP4 clip to X.
`x_ads_rename_campaign`	Rename an X Ads campaign. The name is the only thing that changes.
`x_ads_rename_line_item`

只显示了开头部分；其余内容请在仓库中阅读