API Reference

x-ads / API Reference

x_ads_add_targeting

X (Twitter) Ads tool, proxied to X's own Ads MCP gateway. Add one targeting criterion to an X line item. One call per criterion. A line item with no criteria serves broadly, which is rarely what anyone wants. Get targeting_value from x_ads_search_targeting_interests or x_ads_search_targeting_locations.

This is a read-only tool: it returns x ads add targeting for your x-ads account. It changes nothing.

Ask Claude

You do not call this tool yourself. Ask for the outcome and the client picks the tool:

X ads add targeting in my x-ads account for [line item id], [targeting type], [targeting value].

It takes 4 required and 1 optional parameter.

Parameters

ParameterTypeRequiredDescription
account_idstringYesAccount Id
line_item_idstringYesLine Item Id
targeting_typestringYesTargeting Type
targeting_valuestringYesTargeting Value
operator_typestringNoOperator Type

Related x-ads tools

Before you can call it

This tool needs a connected x-ads account. The x-ads connect guide covers how to authorize it and what it unlocks, and the quickstart gets a client talking to the server in about five minutes.

Start free — 30 tool calls a month

No card required. Connect Google Ads, Meta Ads, GA4 or Search Console and ask Claude for the outcome — it picks the tool.