Start free
    Menu
    How it worksIntegrationsCustomersPricingSign in

    integrations tools meta-ads

    Meta Ads MCP for your AI agent

    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.

    • 12readonly reads data.
    • 18writecreates 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 Meta Ads in Cogny. Every Meta 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 12 · only reads data

    • 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_resolve_partnership_ad_codeReadResolve a creator-shared partnership ad code to the advertisable IG post(s).
    • 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.

    Write 18 · creates or changes something

    • 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_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_upload_ad_imageWriteUpload an image to the ad account's image library and get its hash.
    • 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.

    Destructive 1 · deletes, removes or replaces something

    • tool_delete_custom_audienceDestructiveDelete a 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 markdownAll integrationsHow Cogny uses Meta Ads