x_ads_lookup_users

Resolve X handles to numeric user IDs, for follower look-alike targeting (add_targeting_criterion with targeting_type FOLLOWERS_OF_USER and the ID as…

View as Markdown

Resolve X handles to numeric user IDs, for follower look-alike targeting (add_targeting_criterion with targeting_type FOLLOWERS_OF_USER and the ID as targeting_value). Needs the users.read and tweet.read permissions on the X connection; without them it says so and names what works instead. Each lookup uses X developer API credits.

Source: X Ads
Kind: Read
Discovery: Reachable through search_tools and run_tool
Account parameter: account_id
Endpoint: https://mcp.getmcpads.com/x-ads/mcp

Parameters

Parameters
Name	Type	Required	Notes
`usernames`	array	Required	X handles, with or without @, up to 100.

Calling it

json · Through run_tool, since it is not announced

{
  "name": "run_tool",
  "arguments": {
    "name": "x_ads_lookup_users",
    "args": {
      "usernames": "<array>"
    }
  }
}

Manage your ads from your AI assistant

Start for free

Free with 1 ad account, no card. Pro is free for 7 days.