# 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. ## 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`. How Cogny uses X Ads: https://cogny.com/integrations/x-ads --- All integrations: https://cogny.com/integrations/tools/index.md Plans, approvals, limits and data protection: https://cogny.com/buying-guide.md What Cogny is: https://cogny.com/llms.txt