X Ads tools in Cogny
Cogny's X Ads integration exposes 36 tools (15 read, 16 write, 5 destructive) to an AI agent over MCP. The same tools are available on every plan, from your own AI client or inside the Cogny app.
- Read (15): only reads data.
- Write (16): creates or changes something.
- Destructive (5): deletes, removes or replaces something.
Over MCP your own AI client asks before it runs a write. To take a tool away from your agent, block it in Settings → Integrations. Plans, approvals and limits.
All tools
| Tool | Kind | What it does |
|---|---|---|
tool_list_ad_accounts | Read | Lists all X ad accounts accessible by the current user. |
tool_get_funding_instruments | Read | Get funding instruments (payment methods) for an ad account. |
tool_get_web_event_tags | Read | List X Ads conversion pixels (Web Event Tags) on an account. |
tool_upload_media | Write | Upload a video / image / GIF to X's media library and return a `media_key` usable in `create_card` (MEDIA component) and `create_tweet` (`media_keys`). |
tool_search_locations | Read | Search X Ads location targeting values. |
tool_search_conversations | Read | Search X Ads conversation topic targeting values. |
tool_search_events | Read | Search X Ads event targeting values. |
tool_get_campaigns | Read | Get campaigns for an ad account. |
tool_get_line_items | Read | Get line items (ad groups) for an ad account. |
tool_get_promoted_tweets | Read | Get promoted tweets (ads) for an ad account. |
tool_get_analytics | Read | Get performance analytics for campaigns, line items, or promoted tweets. |
tool_get_tailored_audiences | Read | Get tailored audiences (custom audiences) for an ad account. |
tool_get_targeting_criteria | Read | Get targeting criteria for line items. |
tool_create_campaign | Write | Create a new campaign. |
tool_update_campaign | Write | Update an existing campaign. |
tool_update_campaign_status | Write | Update a campaign's status (pause, activate, or set to draft). |
tool_delete_campaign | Destructive | Delete a campaign. |
tool_create_line_item | Write | Create a new line item (ad group). |
tool_update_line_item | Write | Update an existing line item. |
tool_update_line_item_status | Write | Update a line item's status (pause, activate, or set to draft). |
tool_delete_line_item | Destructive | Delete a line item. |
tool_create_promoted_tweet | Write | Create a promoted tweet (ad) by associating an existing tweet with a line item. |
tool_update_promoted_tweet_status | Write | Update a promoted tweet's status. |
tool_delete_promoted_tweet | Destructive | Delete a promoted tweet. |
tool_create_tailored_audience | Write | Create a tailored audience (custom audience). |
tool_update_tailored_audience | Write | Update a tailored audience. |
tool_delete_tailored_audience | Destructive | Delete a tailored audience. |
tool_add_targeting_criteria | Write | Add targeting criteria to a line item. |
tool_delete_targeting_criteria | Destructive | Delete targeting criteria from a line item. |
tool_get_tweets | Read | Fetch X Ads tweets — the actual creative behind a promoted tweet. |
tool_get_cards | Read | List X Ads Cards (creative attachments referenced by `card_uri` on a tweet). |
tool_get_card | Read | Get a single Card with its full `components` list. |
tool_create_tweet | Write | Create a new tweet usable as ad creative. |
tool_update_tweet | Write | Update a Promoted-only tweet (only nullcast=True tweets can be updated — published tweets are immutable). |
tool_create_card | Write | Create a new X Ads Card (V2). |
tool_update_card | Write | Update a Card's name and/or components. |
Exact input schemas come from tools/list once X Ads is connected; the free plan is enough to check. Missing something? Your agent can ask for it with request_feature.
This page as markdown · All integrations · How Cogny uses X Ads