X Ads account posts
List posts (tweets) usable for promotion by an ads account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths. Works on your own X Ads account, connected through Get MCP Ads. Needs account id and tweet type.
Inputs
- Account ID
- X Ads account ID selected in SourcesRequired · account_id
- Tweet type
- Post type to list (the legacy API requires this filter) (PUBLISHED, SCHEDULED or DRAFT)Required · tweet_type
- Count
- Number of records to return per page (1-1000)Optional · count
- Cursor
- Pagination cursor from a previous responseOptional · cursor
- Include mentions and replies
- Include mentions and replies in the results (default false)Optional · include_mentions_and_replies
- Timeline type
- Scope to promoted-only, organic or all posts (default NULLCAST) (ALL, NULLCAST or ORGANIC)Optional · timeline_type
- Trim user
- Return only the author's user ID instead of the full user object (default false)Optional · trim_user
- Tweet IDs
- Comma-separated post (tweet) IDs to scope the response toOptional · tweet_ids
- User ID
- Promotable user whose posts to list (defaults to the account's own user)Optional · user_id
- Workspace ID
- Authorized workspace ID from list_accounts/list_workspacesOptional · workspace_id
Pricing
- Price
- $0.005 per call
- 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
Connect your agent to 2,400+ tools for free
Sign in with Google or GitHub. No card required.