Start free
    Menu
    How it worksIntegrationsCustomersPricingSign in

    integrations tools openai-ads

    OpenAI Ads MCP for your AI agent

    Cogny's OpenAI Ads integration exposes 32 tools (15 read, 16 write, 1 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.

    • 15readonly reads data.
    • 16writecreates or changes something.
    • 1destructivedeletes, 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

    set it up.

    Add Cogny to your AI client once, then connect OpenAI Ads in Cogny. Every OpenAI Ads tool below appears in the client.

    • Claude CodeRun claude mcp add --transport http cogny https://app.cogny.com/mcp, then authorise in the browser.
    • Claude.aiSettings → Connectors → Add custom connector, URL https://app.cogny.com/mcp, then log in and pick your workspace.
    • ChatGPTSettings → Apps → Advanced settings → Developer mode → Create app, URL https://app.cogny.com/mcp, authentication OAuth.
    • CursorIn Cogny, Settings → Data & Integrations → Connect AI Clients shows the block to paste into .mcp.json, with an API key.
    • CodexRun codex mcp add cogny --url https://app.cogny.com/mcp.

    Full setup, and how to undo it

    what each tool does.

    Read 15 · only reads data

    • tool_get_ad_accountReadGet the connected ad account: id, name, url, status, timezone, currency_code and review.status (must be `approved` to serve ads).
    • tool_get_campaignsReadList campaigns in the ad account.
    • tool_get_campaignReadRetrieve one campaign by id (cmpn_…): status, budget, bidding_type, targeting, schedule, conversion_event_setting_ids.
    • tool_get_ad_groupsReadList ad groups in a campaign (bidding_config, context_hints, product_set).
    • tool_get_ad_groupReadRetrieve one ad group by id (adgrp_…).
    • tool_get_adsReadList ads in an ad group with creative (title, body, target_url, file_id), status and review_status (in_review | approved | rejected).
    • tool_get_adReadRetrieve one ad by id (ad_…).
    • tool_get_insightsReadPerformance insights: impressions, clicks, spend, ctr, cpc, cpm.
    • tool_get_conversion_insightsReadConversion metrics (conversions, click_through_conversions, view_through_conversions) for conversion-tracked campaigns.
    • tool_search_geo_locationsReadFind targeting location ids (countries, regions, DMAs, postal codes) by name, e.g. "Stockholm" → id 2000720 (Stockholms län).
    • tool_list_custom_audiencesReadList custom audiences with processing status and privacy-preserving size ranges. intended_use (exclusion | inclusion | bid_multiplier) adds use-specific eligibility — inclusion and bid multipliers need roughly 25,000…
    • tool_get_custom_audienceReadRetrieve one custom audience (caud_…) with status, membership_revision and matched-user count range.
    • tool_list_pixelsReadList conversion pixels (web sources): id (cds_…), name, pixel_id.
    • tool_get_pixel_eventsReadShow up to 50 events a pixel received in the last 15 minutes — the quickest way to verify the site tag or Conversions API is firing. pixel_id is the `pixel_id` value from tool_list_pixels.
    • tool_list_conversion_event_settingsReadList conversion event settings (ces ids used by conversion-optimized campaigns): event_type, attribution window, source pixels, campaigns using them.

    Write 16 · creates or changes something

    • tool_create_campaignWriteCreate a campaign.
    • tool_update_campaignWriteUpdate campaign fields.
    • tool_update_campaign_statusWriteActivate, pause or archive a campaign (status: active | paused | archived).
    • tool_create_ad_groupWriteCreate an ad group inside a campaign.
    • tool_update_ad_groupWriteUpdate an ad group.
    • tool_update_ad_group_statusWriteActivate, pause or archive an ad group (status: active | paused | archived).
    • tool_upload_imageWriteUpload an image from a public URL and get back a file_id for tool_create_ad (creative image) — or, with purpose='account_favicon' (min 128×128 px), for the account brand favicon.
    • tool_create_adWriteCreate an ad (a ChatGPT chat card) inside an ad group.
    • tool_update_adWriteUpdate an ad's name or creative.
    • tool_update_ad_statusWriteActivate, pause or archive an ad (status: active | paused | archived).
    • tool_preview_adWriteGenerate a shareable preview of how the ad renders in ChatGPT. The preview link expires after 24 hours.
    • tool_create_custom_audienceWriteCreate a custom audience, optionally seeding it inline.
    • tool_add_custom_audience_membersWriteAdd members to a custom audience inline (see tool_create_custom_audience for the identifier shape).
    • tool_remove_custom_audience_membersWriteRemove members from a custom audience inline.
    • tool_create_pixelWriteCreate a web conversion pixel.
    • tool_create_conversion_event_settingWriteCreate a conversion event setting so campaigns can optimize toward it.

    Destructive 1 · deletes, removes or replaces something

    • tool_archive_custom_audienceDestructivePermanently archive a custom audience.

    Exact input schemas come from tools/list once OpenAI Ads is connected; the free plan is enough to check. Missing something? Your agent can ask for it with request_feature.

    This page as markdownAll integrationsHow Cogny uses OpenAI Ads