diff --git a/changelog.mdx b/changelog.mdx index b965396ee..0e2b83be9 100644 --- a/changelog.mdx +++ b/changelog.mdx @@ -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). + + ### 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. + + ### Media upload and Post-create size and duration limits