integrations tools tiktok-ads

    TikTok Ads MCP for your AI agent

    Cogny's TikTok Ads integration exposes 20 tools (10 read, 7 write, 3 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.

    • 10readonly reads data.
    • 7writecreates or changes something.
    • 3destructivedeletes, 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 TikTok Ads in Cogny. Every TikTok 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 10 · only reads data

    • tool_list_advertisersReadLists all TikTok advertiser accounts accessible by the current user.
    • tool_get_campaignsReadGet campaigns for an advertiser.
    • tool_get_ad_groupsReadGet ad groups for an advertiser or specific campaign.
    • tool_get_adsReadGet ads for an advertiser, campaign, or ad group.
    • tool_get_insightsReadGet performance insights/metrics for an advertiser.
    • tool_get_audiencesReadGet custom audiences for an advertiser.
    • tool_get_pixelsReadGet TikTok Pixels for an advertiser.
    • tool_search_locationsReadLook up TikTok location_ids for ad-group geo targeting.
    • tool_list_identitiesReadList ad identities (the TikTok account an ad runs under).
    • tool_list_authorized_postsReadList organic TikTok posts authorized as Spark Ad sources.

    Write 7 · creates or changes something

    • tool_update_campaign_budgetWriteUpdate the budget of a campaign.
    • tool_update_ad_group_budgetWriteUpdate the budget of an ad group.
    • tool_create_campaignWriteCreate a new advertising campaign.
    • tool_create_ad_groupWriteCreate a new ad group within a campaign.
    • tool_create_adWriteCreate a new ad within an ad group.
    • tool_authorize_spark_postWriteAuthorize an organic TikTok post as a Spark Ad source via auth code.
    • tool_upload_videoWriteUpload a video to TikTok's asset library and return a video_id usable in create_ad (ad_format='SINGLE_VIDEO').

    Destructive 3 · deletes, removes or replaces something

    • tool_update_campaign_statusDestructiveUpdate the status of a campaign.
    • tool_update_ad_group_statusDestructiveUpdate the status of an ad group.
    • tool_update_ad_statusDestructiveUpdate the status of an ad.

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