NotFairNot Fair
Docs
Documentation menu

Platforms

X (Twitter) Ads

Campaigns, line items, funding instruments, and promoted-Tweet performance via the X Ads API.

The X (Twitter) Ads server exposes the X hierarchy: ad account → funding instruments → campaigns → line items (ad groups) → promoted Tweets. Analysis runs through ads.get, ads.getParallel, and ads.stats in runScript.

Server URL

https://notfair.co/api/mcp/x_ads
  • Money fields are *_local_micro — local currency × 1e6 (e.g. $5.50 = 5,500,000).
  • Entity state is entity_status (ACTIVE / PAUSED / DRAFT); pausing is a PUT, not a separate endpoint.
  • Synchronous stats cover up to 7 days; longer windows use asynchronous jobs.

See the X Ads MCP reference for details.