X Ads MCP API reference

Every X Ads tool the MCP server exposes, with its parameters. 26 tools, 0 metrics and 0 dimensions, on a dedicated endpoint.

30 rows

Campaigns, ad groups, promoted posts, targeting and native performance via X’s official MCP.

Connection

Platform id: x_ads
Tool prefix: x_ads_
Account parameter: account_id
Dedicated endpoint: https://mcp.getmcpads.com/x-ads/mcp
Access: Available for authorized, selected accounts.
Tools: 26, 10 of which write
Metrics: 0
Dimensions: 0

Scope requestedLink to this section

Scope	Grants	Allows writes
`ads.read`	Read authorized X Ads accounts, campaigns, creatives, targeting and performance.	No
`ads.write`	Create and manage X Ads campaigns, ad groups, targeting and promoted posts.	Yes
`offline.access`	Renew the X authorization without another sign-in.	No

CataloguesLink to this section

Write tools (10)Link to this section

Absent from the tool list on the Free plan. Each one previews by default and needs a second call with confirm: true.

Tool	What it does	Kind	Discovery
`x_ads_activate_campaign`	Activate a campaign (set entity_status=ACTIVE).	Write	On demand
`x_ads_activate_line_item`	Activate a line item (set entity_status=ACTIVE).	Write	On demand
`x_ads_add_targeting_criterion`	Add one targeting criterion to a line item (call once per criterion).	Write	On demand
`x_ads_create_ad_post`	Compose a promoted-only ("nullcasted") post to use as an ad creative.	Write	On demand
`x_ads_create_campaign`	Create a campaign in an ads account.	Write	On demand
`x_ads_create_line_item`	Create a line item (ad group) under a campaign.	Write	On demand
`x_ads_promote_post`	Attach post(s) to a line item as its ad creative(s).	Write	On demand
`x_ads_remove_targeting`	Remove a targeting criterion from its line item (undo a targeting mistake).	Write	On demand
`x_ads_update_campaign`	Rename a campaign or pause it (entity_status=PAUSED).	Write	On demand
`x_ads_update_line_item`	Update a line item's bid, budget, name, schedule, placements, goal, pacing, audience expansion (set audience_expansion=EXPANDED to turn on Optimized Targeting) or entity_status.	Write	On demand

Read tools (16)Link to this section

Tools marked Announced appear in your client's tool list. The rest are reachable through search_tools and run_tool, which run the same checks.

Tool	What it does	Kind	Discovery
`x_ads_get_account_stats`	Get synchronous analytics (impressions, engagements, spend) for an ads account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.	Read	On demand
`x_ads_get_active_entities`	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 ending in _micro are millionths of the account currency.	Read	On demand
`x_ads_get_campaign`	Get a single campaign by ID Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.	Read	On demand
`x_ads_get_campaign_reach`	Get reach and average-frequency metrics for campaigns Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.	Read	On demand
`x_ads_get_line_item`	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.	Read	On demand
`x_ads_list_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 of the account currency.	Read	On demand
`x_ads_list_ads_accounts`	List the ads accounts the authenticated user can access Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.	Read	Announced
`x_ads_list_campaigns`	List campaigns for an account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.	Read	On demand
`x_ads_list_funding_instruments`	List funding instruments (payment sources) for an ads account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.	Read	On demand
`x_ads_list_line_item_placements`	List valid placement combinations per line item product type Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.	Read	On demand
`x_ads_list_line_items`	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 currency.	Read	On demand
`x_ads_list_promoted_posts`	List promoted posts (promoted tweets) for an ads account Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.	Read	On demand
`x_ads_list_targeting_criteria`	List targeting criteria for an ads account's line items Native X fields and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.	Read	On demand
`x_ads_list_web_event_tags`	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 and pagination are preserved; monetary fields ending in _micro are millionths of the account currency.	Read	On demand
`x_ads_search_targeting_interests`	Search targetable interest categories by name.	Read	On demand
`x_ads_search_targeting_locations`	Search targetable locations by name.	Read	On demand

MCP resourcesLink to this section

Read these with resources/read for machine readable metadata about the source.

Name	URI
X Ads reporting and writes	`x-ads://guide`