Skip to content

Upload X Ads media

Upload an image, GIF or MP4 clip to X. Works on your own X Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs account id, media base64 and media type.

Inputs

3 required
Account ID
X Ads account selected in SourcesRequired · account_id
Media base64
File bytes as base64, without a data URL prefixRequired · media_base64
Media type
MIME type matching the actual uploaded file bytes (image/png, image/jpeg, image/gif or video/mp4)Required · media_type
Confirm
False previews only; true uploads after human confirmation, potentially charging X developer API creditsOptional · confirm
Workspace ID
Authorized workspace ID from list_accounts/list_workspacesOptional · workspace_id
Reason
Why, in the person's words or from the evidence (e.g. CPA twice the target for 7 days)Optional · reason

Pricing

Price
Free preview, $0.05 per applied change
Billing
The provider’s price, with no markup. Billed for measured usage.

Call

Your agent reads the schema and the price with inspect_tool before it runs the tool.

MCP call
cURL command
TypeScript
Tool ID

Alternatives

X Ads creatives

Connect your agent to 2,400+ tools for free

Sign in with Google or GitHub. No card required.