MCP.Market

X Ads MCP server

by getmcpads.com·com.getmcpads/x-ads·v1.1.1
No reviews yet

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

B80/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B80/100

full report

Adoption
Growing

0 stars167 downloads/wk

Reviews

Write one

Nobody has reviewed X Ads yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

X Ads tools (2, 2 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • x_ads_get_media_upload_statuswrite action

    Read processing status of an upload owned by the connected X user. Media uploads are user-owned until registered in the selected account's media library.

  • x_ads_upload_mediawrite action

    Upload an image, GIF or MP4 clip to X. Preview includes size and SHA-256 only. X API credits may be charged. Images use one request; video/GIF use initialize, append and finalize without retries. Check processing before registering the returned media_key with create_media_library_item. Does not create or activate an ad.

Public scan report

scanner v0.1.10 · 2026-11-04 · same rubric, same numbers if you re-run it

no findings
  • Code scan7 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 9 days ago15/15
  • Maintainer identitynamespace and repository owner differ; website matches verified namespace6/10
Overall 80/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How X Ads compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
80/100
higher than 60% of 48,255 servers
Tools
2
the typical server has 7
Tools that change things
100%
typical: 0%. Fewer write tools means less an agent can break
Downloads a week
167
more than 72% of 12,191 servers with a package

What its tools let an agent do: 2 change

Release history: 3 versions in the registry since 2026-09-23, latest 2026-10-26, typically one every 30 days.

Install X Ads in Claude Code, Cursor or VS Code

Runs npx -y @getmcpads/x-ads-mcp-server on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add x-ads -- npx -y @getmcpads/x-ads-mcp-server
Add to Cursor

What the publisher says

From the X Ads repository's README, as published. We do not edit it. Read it on GitHub

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 demo · What's new · Install · Tool reference · Try hosted getmcpads

Play the 27-second product film

The film demonstrates hosted getmcpads with staged data. Its creative galleries and MCP Apps interface belong to the hosted product. This repository provides the standalone native API tools.

25 read tools · 19 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.0.1: First standalone release · September 20, 2026

  • Create the first runnable standalone server using the reviewed native tool subset.
  • Require explicit account IDs, default to read-only, preview writes and preserve native pagination.
  • Use fixed X endpoints, bounded responses, timeouts and credential redaction without automatic write retries.
  • Require Node.js 22.12 or newer and check Node 22/24 in CI.
  • Update vulnerable dependencies and regenerate the MCP catalog.

Full changelog · Source synchronization details · All releases

Upgrade notes

Requires Node.js 22.12 or newer. CI covers Node 22 and 24. 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; unpinned npx examples later in this document select the version currently available on npm.

git clone --branch v1.0.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:

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

X Ads: common questions

Is X Ads MCP server safe?
Mostly: it is graded B (80/100). Read the X Ads safety report
How do I install X Ads?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does X Ads need an API key?
Yes. The registry entry asks for X_ADS_ACCESS_TOKEN.
Is X Ads maintained?
The last commit was 9 days ago (2026-10-26). The latest release is v1.1.1.
What can I use instead of X Ads?
Servers from other publishers that do the same job: AdLoop MCP server.
How does X Ads compare with other MCP servers?
safety score 80/100 (higher than 60% of 48,255 servers); tools 2 (the typical server has 7); tools that change things 100% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to X Ads

Same job from other publishers: the closest match first, then the best rated.

  • AdLoop
    Google Ads, Reddit Ads, GA4 and Tag Manager in your AI client, with a preview before every change.
    A

More from getmcpads.com →