x-ads / API Reference
x_ads_list_account_posts
X (Twitter) Ads tool, proxied to X's own Ads MCP gateway. List posts usable for promotion by an X ad account. tweet_type is PUBLISHED (organic posts) or SCHEDULED.
This is a read-only tool: it returns x ads list account posts 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 list account posts in my x-ads account.
It takes 1 required and 2 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
account_id | string | Yes | Account Id |
tweet_type | string | No | Tweet Type |
count | integer | No | Count |
Related x-ads tools
x_ads_list_accountsx_ads_list_campaignsx_ads_list_funding_instrumentsx_ads_list_gateway_toolsx_ads_list_line_itemsx_ads_list_promoted_posts
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.