# X Ads reporting MCP

16 tools on your own X Ads account, from $0.005 per call.

## Implementations

- [X Ads account posts](/providers/x-ads/list-account-posts.md): `x-ads/list-account-posts`, $0.005 per call. 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.
- [X Ads account stats](/providers/x-ads/get-account-stats.md): `x-ads/get-account-stats`, $0.005 per call. Get synchronous analytics (impressions, engagements, spend) for an ads account Native X fields and pagination are preserved; monetary fields ending in _micro. Works on your own X Ads account, connected through Get MCP Ads. Needs account id, end time, entity and more.
- [X ads accounts](/providers/x-ads/list-ads-accounts.md): `x-ads/list-ads-accounts`, $0.005 per call. List the ads accounts the authenticated user can access 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. Takes account ids and workspace id, all optional.
- [X Ads active entities](/providers/x-ads/get-active-entities.md): `x-ads/get-active-entities`, $0.005 per call. List which ads entities had metrics change in a time window (use before requesting account stats) Native X fields and pagination are preserved; monetary fields. Works on your own X Ads account, connected through Get MCP Ads. Needs account id, end time, entity and more.
- [X Ads campaign](/providers/x-ads/get-campaign.md): `x-ads/get-campaign`, $0.005 per call. Get a single campaign by ID Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency. Works on your own X Ads account, connected through Get MCP Ads. Needs account id and campaign id.
- [X Ads campaign reach](/providers/x-ads/get-campaign-reach.md): `x-ads/get-campaign-reach`, $0.005 per call. Get reach and average-frequency metrics for campaigns 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, campaign ids, end time and more.
- [X Ads campaigns](/providers/x-ads/list-campaigns.md): `x-ads/list-campaigns`, $0.005 per call. List campaigns for an account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency. Works on your own X Ads account, connected through Get MCP Ads. Needs account id.
- [X Ads funding instruments](/providers/x-ads/list-funding-instruments.md): `x-ads/list-funding-instruments`, $0.005 per call. List funding instruments (payment sources) for 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.
- [X Ads line item](/providers/x-ads/get-line-item.md): `x-ads/get-line-item`, $0.005 per call. Get a single line item by ID Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency. Works on your own X Ads account, connected through Get MCP Ads. Needs account id and line item id.
- [X Ads line item placements](/providers/x-ads/list-line-item-placements.md): `x-ads/list-line-item-placements`, $0.005 per call. List valid placement combinations per line item product type 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. Takes product type and workspace id, all optional.
- [X Ads line items](/providers/x-ads/list-line-items.md): `x-ads/list-line-items`, $0.005 per call. List line items (ad groups) for an ads account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account. Works on your own X Ads account, connected through Get MCP Ads. Needs account id.
- [X Ads post previews](/providers/x-ads/list-post-previews.md): `x-ads/list-post-previews`, $0.005 per call. Get rendered HTML previews for published or scheduled posts 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, tweet ids and tweet type.
- [X Ads promoted post](/providers/x-ads/get-promoted-post.md): `x-ads/get-promoted-post`, $0.005 per call. Get a single promoted post by ID Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency. Works on your own X Ads account, connected through Get MCP Ads. Needs account id and promoted tweet id.
- [X Ads promoted posts](/providers/x-ads/list-promoted-posts.md): `x-ads/list-promoted-posts`, $0.005 per call. List promoted posts (promoted tweets) for 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.
- [X Ads web event tag](/providers/x-ads/get-web-event-tag.md): `x-ads/get-web-event-tag`, $0.005 per call. Get a single website conversion event tag by ID Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account. Works on your own X Ads account, connected through Get MCP Ads. Needs account id and web event tag id.
- [X Ads web event tags](/providers/x-ads/list-web-event-tags.md): `x-ads/list-web-event-tags`, $0.005 per call. List the website conversion event tags (pixels) in an ads account; a tag's id is what a conversion line item takes as its primary_web_event_tag Native X fields. Works on your own X Ads account, connected through Get MCP Ads. Needs account id.

## Same data on other platforms

- [DOU+ promotion data](/tools/douyin/douplus.md): 17 tools, from $0.001 per call.

## Other capabilities

- [X Ads campaign management](/tools/x-ads/campaign-management.md): 11 tools, from $0.05 per applied change.
- [X Ads creatives](/tools/x-ads/creatives.md): 10 tools, from $0.005 per call.
- [X Ads audiences & targeting](/tools/x-ads/audiences.md): 6 tools, from $0.005 per call.

## Providers

- [X Ads](/providers/x-ads.md): 44 tools, from $0.005 per call.

## Questions

### Do I need my own X Ads account?

Yes. These tools work on your own account, connected once per workspace through Get MCP Ads.

### Can my agent change anything?

No. These tools only read.

### How is it billed?

Per call, at the provider's price with no markup, from $0.005 per call. Your agent sees the price before it runs a tool.

[X Ads](/tools/x-ads.md) · [Connection guide](/connect.md) · [Billing](/docs/billing.md)

---

[HTML page](/tools/x-ads/reporting) · [Agent index](/llms.txt)
