❯

    integrations / meta-ads / tools

    Meta Ads tools in Cogny

    Cogny's Meta Ads integration exposes 31 tools (12 read, 18 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.

    • Read (12): only reads data.
    • Write (18): creates or changes something.
    • Destructive (1): 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

    ToolKindWhat it does
    tool_list_ad_accountsReadLists all Meta ad accounts accessible by the current user.
    tool_get_campaignsReadGet campaigns for an ad account.
    tool_get_ad_setsReadGet ad sets for an ad account or specific campaign.
    tool_get_adsReadGet ads for an ad account, campaign, or ad set.
    tool_get_insightsReadGet performance insights/metrics for an ad account or specific objects.
    tool_get_pixelsReadGet Meta Pixels for an ad account, including the pixel base code.
    tool_get_custom_audiencesReadGet custom audiences for an ad account.
    tool_get_facebook_pagesReadGet Facebook pages accessible by the current user.
    tool_update_campaign_statusWriteUpdate the status of a campaign.
    tool_update_ad_set_statusWriteUpdate the status of an ad set.
    tool_update_ad_statusWriteUpdate the status of an ad.
    tool_update_campaign_budgetWriteUpdate the budget of a campaign.
    tool_update_ad_set_budgetWriteUpdate the budget or bid of an ad set.
    tool_update_ad_set_url_tagsWriteUpdate the URL parameters (tracking tags) for an ad set.
    tool_update_ad_set_targetingWriteUpdate targeting settings for an ad set.
    tool_update_ad_set_placementsWriteUpdate placement targeting for an ad set.
    tool_update_ad_set_custom_audiencesWriteUpdate custom audience targeting for an ad set (for retargeting).
    tool_delete_custom_audienceDestructiveDelete a custom audience.
    tool_create_campaignWriteCreate a new advertising campaign.
    tool_create_ad_setWriteCreate a new ad set within a campaign.
    tool_create_adWriteCreate a new ad within an ad set.
    tool_create_ad_creativeWriteCreate a reusable ad creative.
    tool_resolve_partnership_ad_codeReadResolve a creator-shared partnership ad code to the advertisable IG post(s).
    tool_upload_ad_imageWriteUpload an image to the ad account's image library and get its hash.
    tool_get_video_thumbnailsReadGet auto-generated thumbnails for an uploaded video.
    tool_get_ad_previewReadGet a renderable preview of a live ad for embedding in the chat UI.
    tool_get_videoReadGet the playable MP4 source URL + larger poster for an uploaded video.
    tool_update_adWriteSwap an existing ad's creative (and/or rename it) without recreating it.
    tool_update_ad_creativeWriteUpdate an existing ad creative.
    tool_create_website_custom_audienceWriteCreate a custom audience based on Meta Pixel website events.
    tool_create_lookalike_audienceWriteCreate a lookalike audience from an existing custom audience.

    Exact input schemas come from tools/list once Meta 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 Meta Ads