Skip to content

Add an X Ads targeting criterion

Add one targeting criterion to a line item (call once per criterion). 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, line item id, targeting type and more.

Inputs

4 required
Account ID
X Ads account ID selected in SourcesRequired · account_id
Line item ID
Line item to add the criterion toRequired · line_item_id
Targeting type
Criterion type, e.g. LOCATION, INTEREST, BROAD_KEYWORD, PHRASE_KEYWORD, EXACT_KEYWORD, FOLLOWERS_..Required · targeting_type
Targeting value
Value for the type: a targeting ID for LOCATION/INTEREST (look up via targeting search), a user I..Required · targeting_value
Operator type
Comparison operator (EQ, NE, GTE or LT)Optional · operator_type
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 audiences & targeting

Connect your agent to 2,400+ tools for free

Sign in with Google or GitHub. No card required.