X Ads tools
X (Twitter) ad accounts and campaigns, daily budget and status changes; every change can be undone.
Tool names and descriptions are generated straight from the server code; the descriptions are the original English text the assistant sees.
Read tools2 tools
list_x_ads_accounts
Read1 creditsX (Twitter) Ads accounts reachable through the connected X login: account_id, name, currency, approval status and which one is selected. Read only; connected=false when X isn't connected.
This tool takes no parameters.
list_x_campaigns
Read1 creditsX Ads campaigns of the account: id, name, status, daily and total budget (account currency), funding instrument, schedule and serving issues. Read only; never invents numbers.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | X ad account id; defaults to the connection's selected account |
statusOptional | active | paused | draft | — |
Write tools2 tools
update_x_campaign_status
Write2 creditsPause or activate an X Ads campaign. Applied when the user asks, recorded in the audit log and undoable with undo_action.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | X ad account id; defaults to the connection's selected account |
campaign_idRequired | string | — |
statusRequired | pause | activate | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
update_x_campaign_budget
Write2 creditsSet an X Ads campaign daily budget (account currency). Increases above 50% per change or 2x per 24 hours are blocked; undoable with undo_action.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | X ad account id; defaults to the connection's selected account |
campaign_idRequired | string | — |
daily_budgetRequired | number | new daily budget in the account currency |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.