Create an X Ads media library item

Register an existing media key as a named item in the account's media library. 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 and media key.

Inputs

2 required

Account ID: X Ads account ID selected in SourcesRequired · account_id
Media key: Media key of an existing media asset (e.g. 13_875943225764098048)Required · media_key
Description: Video description, shown under the videoOptional · description
File name: Media file name (1-255 characters)Optional · file_name
Name: Media asset name, shown in campaign setup UIs (1-100 characters)Optional · name
Poster media key: Media key of an uploaded image to use as the video poster frameOptional · poster_media_key
Title: Video title, shown on the video itselfOptional · title
Confirm: False previews only; true applies this exact change after explicit human confirmationOptional · 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

Get $5 free credit Get $5 free credit