Skip to content

Draft changelog: X Ads MCP GA with 74 tools #409

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
mintlify wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Draft changelog: X Ads MCP GA with 74 tools #409

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions changelog.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,26 @@ keywords: ["changelog", "API updates", "release notes", "what's new", "API chang

To subscribe to updates, please [**“Turn on notifications”**](https://help.x.com/en/managing-your-account/notifications-on-mobile-devices#:~:text=In%20the%20top%20menu,%20you,you%20would%20like%20to%20receive) for [**@API**](https://x.com/api). You can also follow this changelog in your feed reader via the [**RSS feed**](https://docs.x.com/changelog/rss.xml).

<Update label="Sep 14, 2026" description="X Ads API">
### X Ads MCP is now in production with 74 tools

The [X Ads MCP server](/x-ads-api/mcp) is now generally available at `https://ads-api.x.com/mcp`. Point any MCP-capable client (Grok, Grok Build, Claude Code, or a custom agent) at the endpoint and it can manage X Ads accounts through natural language, with no custom Ads API integration required. See the full [tool reference](/x-ads-api/mcp/reference).

What the 74 tools cover:

- **Accounts, campaigns, and reads** — list and inspect accounts, campaigns, line items, placements, funding instruments, and promoted Posts.
- **Analytics** — `get_account_stats` and `get_campaign_reach` for performance and reach estimates.
- **Targeting and audiences** — search interests and locations, manage custom audiences and do-not-reach lists, and preview reach with `estimate_audience`.
- **Creatives and media** — full lifecycle for cards, media library, account media, and media creatives, plus `list_post_previews`.
- **Conversion tracking** — create and manage web event tags (pixels) and wire them to a line item's `primary_web_event_tag` for end-to-end sales / website-conversion campaigns.
- **App campaigns** — app event tags, tracking tags, and app lists for mobile-app setup.
- **Writes** — create and update campaigns and line items, add targeting, and promote Posts.

Authentication uses the user's own OAuth 2.0 token, so agents only see accounts that user can access. Writes are safe by default: campaigns and line items are always created **PAUSED**, and nothing spends until you explicitly activate them.

See the [Get Started guide](/x-ads-api/mcp#get-started) for setup steps and per-client configuration for Grok, Grok Build, and Claude Code.
</Update>

<Update label="Sep 1, 2026" description="X API v2">
### Media upload and Post-create size and duration limits

Expand Down