# X Ads MCP and API 43 tools on your own X Ads account through Get MCP Ads, from $0.005 per call. ## Capabilities - [X Ads reporting](/tools/x-ads/reporting.md): 16 tools, from $0.005 per call. - [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. ## All 43 tools - [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. - [Activate an X Ads campaign](/providers/x-ads/activate-campaign.md): `x-ads/activate-campaign`, free preview, $0.05 per applied change. Activate a campaign (set entity_status=ACTIVE). Works on your own X Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs account id and campaign id. - [Activate an X Ads line item](/providers/x-ads/activate-line-item.md): `x-ads/activate-line-item`, free preview, $0.05 per applied change. Activate a line item (set entity_status=ACTIVE). Works on your own X Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs account id and line item id. - [Create an X ad post](/providers/x-ads/create-ad-post.md): `x-ads/create-ad-post`, free preview, $0.05 per applied change. Compose a promoted-only ("nullcasted") post to use as an ad creative. Works on your own X Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs account id and as user id. - [Create an X Ads campaign](/providers/x-ads/create-campaign.md): `x-ads/create-campaign`, free preview, $0.05 per applied change. Works on your own X Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs account id, funding instrument id and name. - [Create an X Ads line item](/providers/x-ads/create-line-item.md): `x-ads/create-line-item`, free preview, $0.05 per applied change. Create a line item (ad group) under a campaign. Works on your own X Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs account id, campaign id, daily budget amount local micro and more. - [Create an X Ads web event tag](/providers/x-ads/create-web-event-tag.md): `x-ads/create-web-event-tag`, free preview, $0.05 per applied change. Create a website conversion event tag (pixel); the returned id can be set as a line item's primary_web_event_tag Preview by default. Works on your own X Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs account id. - [Delete an X Ads web event tag](/providers/x-ads/delete-web-event-tag.md): `x-ads/delete-web-event-tag`, free preview, $0.05 per applied change. Delete a website conversion event tag Preview by default. Works on your own X Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs account id and web event tag id. - [Promote an X Ads post](/providers/x-ads/promote-post.md): `x-ads/promote-post`, free preview, $0.05 per applied change. Attach post(s) to a line item as its ad creative(s). Works on your own X Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs account id, line item id and tweet ids. - [Update an X Ads campaign](/providers/x-ads/update-campaign.md): `x-ads/update-campaign`, free preview, $0.05 per applied change. Rename a campaign or pause it (entity_status=PAUSED). Works on your own X Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs account id and campaign id. - [Update an X Ads line item](/providers/x-ads/update-line-item.md): `x-ads/update-line-item`, free preview, $0.05 per applied change. Update a line item's bid, budget, name, schedule, placements, goal, pacing, audience expansion (set audience_expansion=EXPANDED to turn on Optimized Targeting). Works on your own X Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs account id and line item id. - [Update an X Ads web event tag](/providers/x-ads/update-web-event-tag.md): `x-ads/update-web-event-tag`, free preview, $0.05 per applied change. Update a website conversion event tag Preview by default. Works on your own X Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs account id and web event tag id. - [Create an X Ads card](/providers/x-ads/create-card.md): `x-ads/create-card`, free preview, $0.05 per applied change. Create a card from a JSON components payload. Works on your own X Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs account id, components and name. - [Create an X Ads media library item](/providers/x-ads/create-media-library-item.md): `x-ads/create-media-library-item`, free preview, $0.05 per applied change. Register an existing media key as a named item in the account's media library. Works on your own X Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs account id and media key. - [Delete an X Ads card](/providers/x-ads/delete-card.md): `x-ads/delete-card`, free preview, $0.05 per applied change. Works on your own X Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs account id and card id. - [Delete an X Ads media library item](/providers/x-ads/delete-media-library-item.md): `x-ads/delete-media-library-item`, free preview, $0.05 per applied change. Delete a media library object from an ads account Preview by default. Works on your own X Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs account id and media key. - [Update an X Ads media library item](/providers/x-ads/update-media-library-item.md): `x-ads/update-media-library-item`, free preview, $0.05 per applied change. Update a media library object's metadata (e.g. name, title, description) Preview by default. Works on your own X Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs account id and media key. - [Upload X Ads media](/providers/x-ads/upload-media.md): `x-ads/upload-media`, free preview, $0.05 per applied change. Upload an image, GIF or MP4 clip to X. Works on your own X Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs account id, media base64 and media type. - [X Ads card](/providers/x-ads/get-card.md): `x-ads/get-card`, $0.005 per call. Get a single card 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 card id. - [X Ads cards](/providers/x-ads/list-cards.md): `x-ads/list-cards`, $0.005 per call. List the cards in an ads 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 media library](/providers/x-ads/list-media-library.md): `x-ads/list-media-library`, $0.005 per call. List the media library objects in 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 media library item](/providers/x-ads/get-media-library-item.md): `x-ads/get-media-library-item`, $0.005 per call. Get a single media library object by media key 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 media key. - [Add an X Ads targeting criterion](/providers/x-ads/add-targeting-criterion.md): `x-ads/add-targeting-criterion`, free preview, $0.05 per applied change. Add one targeting criterion to a line item (call once per criterion). Works on your own X Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs account id, line item id, targeting type and more. - [Remove X Ads targeting](/providers/x-ads/remove-targeting.md): `x-ads/remove-targeting`, free preview, $0.05 per applied change. Remove a targeting criterion from its line item (undo a targeting mistake). Works on your own X Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs account id and targeting criterion id. - [Search X Ads targeting interests](/providers/x-ads/search-targeting-interests.md): `x-ads/search-targeting-interests`, $0.005 per call. Search targetable interest categories by name. Works on your own X Ads account, connected through Get MCP Ads. Takes count, cursor, q and more, all optional. - [Search X Ads targeting locations](/providers/x-ads/search-targeting-locations.md): `x-ads/search-targeting-locations`, $0.005 per call. Search targetable locations by name. Works on your own X Ads account, connected through Get MCP Ads. Takes count, country code, cursor and more, all optional. - [X Ads targeting criteria](/providers/x-ads/list-targeting-criteria.md): `x-ads/list-targeting-criteria`, $0.005 per call. List targeting criteria for an ads account's line items 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 line item ids. - [X Ads targeting criterion](/providers/x-ads/get-targeting-criterion.md): `x-ads/get-targeting-criterion`, $0.005 per call. Get a single targeting criterion 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 targeting criterion id. ## Related - [X (Twitter)](/tools/x.md): 37 tools, from $0.001 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 X Ads account, connected once per workspace through Get MCP Ads. Agentik keeps an encrypted token and never sees your password. ### Can my agent change things without my approval? No. A change is previewed for free and applied only when you confirm it. Reading never changes anything. ### 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. [Advertising](/tools/advertising.md) · [Connection guide](/connect.md) · [Billing](/docs/billing.md) --- [HTML page](/tools/x-ads) · [Agent index](/llms.txt)