Connect X Ads to an AI assistant

Platform id

x_ads

Tool prefix

x_ads_

Account parameter

account_id

Dedicated endpoint

https://mcp.getmcpads.com/x-ads/mcp

Tools

51, 23 of which write

Announced by default

x_ads_list_ads_accounts

Metrics

75, see /docs/sources/x-ads/metrics

Dimensions

4, see /docs/sources/x-ads/dimensions

Scope requested from the platform

Reaching a tool that is not announced

search_tools({ task: "..." })      find it
describe_tool({ name: "..." })     read its schema
run_tool({ name, args })           execute, with the same checks

What will refuse you

• An account not ticked by the owner. Call list_accounts and use a account_id from it.
• A write on a plan without writes. The tool is absent from the list and refused if called anyway.
• A write without confirm: true returns a preview and applies nothing. That is not an error.
• A call to this platform on another platform's dedicated endpoint. The refusal names the URL that serves it.

Questions this source answers

Images, video and website cards

Upload PNG or JPEG images up to 5 MB, animated GIFs up to 15 MB and MP4 videos up to 16 MB. The Campaign Launcher uploads your files to X itself before it builds the website cards and carousels. Reconnect an older X Ads connection in Sources to grant media.write. Customers authorize their own X account through Get MCP Ads; they do not need to create a developer application.

1. Call get_capabilities with platform x_ads, then describe_tool for the operation you need. Advanced tools remain callable through run_tool even when your assistant's initial tool list is short.
2. Preview x_ads_upload_media with the selected account_id, media_type and base64 file bytes in media_base64. Confirm the reviewed upload. It returns a media ID and media_key; it does not create an ad.
3. For video or GIF processing, call x_ads_get_media_upload_status using the returned media ID. Respect check_after_secs and wait for processing_info.state to become succeeded before using the asset.
4. Register the media_key with x_ads_create_media_library_item. Use the library read, update and delete tools to inspect, rename or remove library entries.
5. Create a promoted-only post with x_ads_create_ad_post, or create a website card with x_ads_create_card and attach its card_uri to a new post. Cards support a single image/video or a carousel of 2 to 6 media keys with one website destination. Replacing a card requires creating a new one.
6. Attach the post with x_ads_promote_post. Read it back with x_ads_list_account_posts, x_ads_get_promoted_post or x_ads_list_promoted_posts, and inspect x_ads_list_post_previews. Every write needs its own preview and confirmation. Keep the parent campaign and ad group paused until delivery is explicitly approved.

Campaigns, targeting and conversion events

Create campaigns and ad groups in pause, then update names, bids, budgets, schedules, placements and frequency settings. Budgets and schedules belong to ad groups (line items). Search location/interest targeting, add or remove criteria, and read them back. Website event tags can be created, read, updated and deleted; creating a tag does not install a pixel or generate conversion traffic.

Permissions, billing and limits

• Free permits reads; Pro, Team and Enterprise permit writes within the selected accounts and provider permissions. Media tools require ads.read, ads.write and media.write on the X connection. The status tool is read-only but still requires those provider scopes.
• X API credits, advertising budgets and account verification are separate. A 402 credits-depleted upload error concerns the developer application: contact Get MCP Ads support for a hosted connection. Buying advertising credit or changing your Get MCP Ads plan does not resolve that error.
• Uploads are not automatically retried. If a partial failure returns an allocated media ID, retain it and inspect its status before starting another upload. The tool accepts file bytes, not an arbitrary download URL.
• X controls verification, advertiser eligibility, creative review and objective prerequisites. Premium verification may block delivery while paused creation still succeeds. App-install and app-engagement objectives require a suitable mobile app.
• App/lead cards, multiple website destinations per carousel and files larger than the upload limits are outside this connector's current scope. X Ads is not yet included in the gateway's cross-platform business reviews or creative galleries. Native performance and post-preview tools remain available.