How to integrate TikTok Ads MCP with Atomic Agent

Connect Atomic Agent to TikTok Ads MCP. List all active campaigns with spend, create campaign for new product launch, and more using natural language, with authentication handled for you.

TikTok Ads logoTikTok Ads
Oauth2

TikTok Ads is TikTok's advertising platform for managing paid media and audiences. It helps advertisers reach engaged users with creative ad formats and performance insights.

131 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including TikTok Ads.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a TikTok Ads account. See the Atomic Agent documentation for installation instructions.

Also integrate TikTok Ads with

How Atomic Agent connects to TikTok Ads

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect TikTok Ads to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in TikTok Ads. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your TikTok Ads account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the TikTok Ads MCP server, and what's possible with it?

The TikTok Ads MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your TikTok Ads account. It provides structured and secure access so your agent can perform TikTok Ads operations on your behalf.

Use TikTok Ads from Atomic Agent

With your account connected, ask Atomic Agent to work with TikTok Ads in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every TikTok Ads action and event your agent gets out of the box.

Appeal Smart+ Ad

Submit an appeal for a Smart+ ad review decision.

Assign TikTok Account To Advertiser

Link a TikTok account to an ad account in the same Business Center.

Get Change Log Download Task Result

Read the status and change-log content returned for an advertiser's change-log task.

Check Advertiser Term Status

Check whether a TikTok advertiser has signed a specified agreement.

Check Change Log Download Task

Check whether an advertiser change-log download task is processing, successful, or failed.

Check File Names

Check whether one or more image or video file names are already used in an advertiser account.

Check GMV Max Occupied Custom Shop Ads

Check which Shopping Ads occupy one TikTok Shop identity or product asset.

Check TikTok Shop GMV Max Availability

Check a TikTok Shop's availability for Product GMV Max campaigns.

Check MMM Data Request

Check one MMM export job.

Check Smart+ Campaign Copy Task

Get the results of an asynchronous Upgraded Smart+ campaign copy task.

Check UnionPay Verification Requirement

Check whether a business license requires UnionPay verification before submitting advertiser verification details.

Create Business Center Asset Group

Create an Asset Group in a TikTok Business Center, add advertiser assets and members, and optionally assign each member an advertiser access role.

Create Business Center Organization Account

Create an Organization Account in an authorized Business Center.

Create Business Spark Ad

Create a campaign, ad group, and Spark Ad in one request.

Create Catalog Product Diagnostic Task

Create an asynchronous download task for catalog product diagnostic information.

Create Catalog Product Set by File

Create an E-commerce catalog product set from an uploaded CSV file.

Create Change Log Download Task

Create an asynchronous download task for an advertiser's change log.

Create Creative Welcome Message

Create a welcome message within a TikTok advertiser account.

Create Creative Pre-Review Task

Create a task to pre-review creative materials for one location.

Create GMV Max Campaign

Create a GMV Max campaign from TikTok's official campaign model.

Create GMV Max Session

Create a max delivery session for a product or a creative boost session for a video.

Create MMM Data Request

Create an irreversible Media Mix Modeling export job after explicit confirmation.

Create Smart+ Ad

Create a Smart+ ad disabled for review in an existing Smart+ ad group.

Create Smart+ Ad Group

Create a Smart+ ad group disabled for review in an existing Smart+ campaign.

Create Smart+ Campaign

Create a Smart+ campaign disabled for review.

Create Smart+ Campaign Copy Task

Create and start an asynchronous copy task for an Upgraded Smart+ campaign.

Create Video Fix Tasks

Create up to 10 Smart Fix tasks for advertiser-owned videos.

Delete Business Center Asset Group

Delete one Asset Group from a TikTok Business Center.

Delete Catalog Video

Permanently delete one uploaded video from an E-commerce catalog.

Delete Creative Assets

Delete video or image assets owned by a TikTok advertiser account.

Delete GMV Max Session

Permanently delete a GMV Max session from an advertiser account.

Delete Customized TikTok Posts

Permanently delete shop-level customized TikTok posts.

Delete Customized Identity

Permanently delete a customized user identity from an advertiser account.

Delete Search Ad Negative Keywords

Delete negative keywords from one Search Ads campaign or ad group in an authorized advertiser account.

Delete Smart+ Resources

Permanently delete up to 20 Smart+ campaigns, ad groups, or ads.

Disable Business Center Advertiser

Irreversibly disable one ad account in a TikTok Business Center.

Get Ad Benchmarks

Get one page of ad benchmark dimensions and dynamic numeric metrics, scoped by exactly one ad_ids, adgroup_ids, or campaign_ids filter.

Get Advertiser Accounts

Return profile, status, timezone, currency, and other default details for specified authorized TikTok advertiser accounts.

Get Asset Binding Quota

Get advertiser binding quota usage for a TikTok identity asset.

Get Bid Protection Details

Get bid protection history for campaigns or ad groups over a date range.

Get Bid Protection Statuses

Get bid protection statuses for up to 200 campaigns or ad groups.

Get Business Center Advertiser Attributes

Get currencies and registration regions available when creating ad accounts in a Business Center.

Get Business Center Asset Group

Get the assets or members of an Asset Group in a Business Center.

Get Business Center Balance

Read the balance of a TikTok Business Center or Payment Portfolio.

Get Campaign Quota Information

Get SKAN Dedicated Campaign quota information by ad network.

Get Catalog Category Insights

Get up to 50 top trending product categories and availability metrics for an eligible E-commerce catalog, optionally filtered by category IDs.

Get Catalog Insight Filters

Get one page of provider-approved category, brand, or availability filter values for product insight endpoints.

Get Catalog Product Diagnostic Task

Get an asynchronous catalog product diagnostic task result.

Get Creative Assets

Return metadata for specified video or image assets in an authorized advertiser's Ads Asset Library.

Get Creative Pre-Review Task

Get the result of a creative pre-review task.

Get Custom Audience Details

Get current status and modification history for specified owned or shared custom audiences.

Get Custom Audience Sharing Log

Get the advertisers with which a specific TikTok custom audience has been shared, including each sharing status.

Get GMV Max Bid Recommendation

Get TikTok's recommended GMV Max bid for an eligible advertiser and shop.

Get GMV Max Campaign Info

Get information for one GMV Max campaign owned by an authorized advertiser.

Get GMV Max Sessions

Get max delivery or creative boost session details by 1 to 20 exact session IDs.

Get GMV Max Exclusive Authorization

Get an advertiser account's exclusive authorization status for a TikTok Shop.

Get GMV Max Report

Run one paginated Product or LIVE GMV Max campaign report.

Get MMM Download URL

Obtain a seven-day signed URL for a completed MMM compressed CSV.

Get MMM Request History

Retrieve MMM request metadata for a UTC+0 date interval.

Get Showcase Identity

Get the identity with Showcase permission under an ad account.

Get Smart+ Material Report

Get one page of Smart+ material overview or breakdown reporting.

Get Smart+ Review Info

Get review information for Smart+ ads or ad materials.

Get Video Fix Task

Get the results of a Smart Fix task.

Get In-Second Video Performance

Get one page of in-second AD or VIDEO performance.

List Ad Accounts Linked to TikTok Account

List one page of ad accounts linked to one TikTok account asset in a Business Center.

List Ad Groups

List regular or mixed-automation ad group inventory through TikTok's generic /adgroup/get/ endpoint.

List Ads

List regular or mixed-automation ad inventory through TikTok's generic /ad/get/ endpoint.

Get Advertiser Balance

Get one page of ad account balances and budgets for a TikTok Business Center, with optional account filters and detailed balance fields.

List Advertiser Budget Changes

Get one page of budget change audit records for an ad account.

List Advertiser Qualifications

List one page of reusable advertiser qualification records in a Business Center, optionally filtered by verification status.

List Advertiser Transactions

List one page of advertiser billing transactions accessible through a Business Center, with optional transaction type, fund type, account, and UTC date filters.

List Business Center Account Costs

Get one page of aggregate Business Center costs and itemized advertiser cost records.

List Business Center Account Transactions

Get one page of itemized billing transactions for a Business Center, its ad accounts, or a Payment Portfolio, including invoice, tax, billing-type, and account details.

Get Business Center Activity Log

Get one page of activity-log records for a Business Center.

List Business Center Advertisers

List one page of advertiser-account assets assigned to the authorized user in a specified TikTok Business Center.

List Business Center Asset Groups

Get one page of Asset Groups in a TikTok Business Center.

List Business Center Asset Partners

Get one page of Business Center partners associated with an asset.

List Business Center Billing Groups

Get one page of billing groups in a TikTok Business Center.

List Business Center Members

Get one page of members in a TikTok Business Center.

List Business Center Partners

Get one page of partners for a TikTok Business Center.

List Business Center Pixel Links

Get one page of ad accounts linked to a TikTok Business Center pixel.

List Business Centers

List one page of Business Centers accessible to the connected TikTok authorization, optionally restricted to one Business Center ID.

List Business Center Transactions

Get one page of Business Center-level cash or grant fund movements, with aggregate charged and paid amounts.

List Campaign Labels

List one page of campaign labels for an authorized advertiser.

List Campaigns

List regular or mixed-automation campaign inventory through TikTok's generic /campaign/get/ endpoint.

Get Catalog Diagnostics

Get one page of synchronous catalog product diagnostic information.

List Catalogs

List catalogs in a specified TikTok Business Center, optionally restricted to one catalog ID.

Get Catalog Videos

Get one page of uploaded videos from a catalog.

Get Creative Welcome Messages

Get one page of welcome messages within a TikTok advertiser account.

Get Creative Fatigue Results

Get one page of Creative Fatigue Detection results for an ad.

List Creative Portfolios

List one provider page of interactive creative portfolios for an advertiser.

List Custom Audiences

List one page of owned and shared custom audiences for an authorized advertiser, optionally restricted to specified audience IDs.

List GMV Max Campaign Sessions

List active max delivery or creative boost sessions for one Product GMV Max campaign ID.

List GMV Max Customized Posts

List one page of shop-level customized TikTok posts for GMV Max.

List GMV Max Identities

List identities available to an advertiser for GMV Max campaigns.

List TikTok Shops for GMV Max

List TikTok Shops available to an advertiser for GMV Max campaigns.

List GMV Max Videos

List one page of authorized or custom-post-eligible TikTok posts for a Product GMV Max campaign.

List Pangle Audience Packages

List the include and exclude audience packages available for an advertiser's Pangle targeting configuration.

Get Recommended Search Keywords

Get 20 TikTok search-keyword recommendations for a product, service, or brand query.

List Search Ad Negative Keywords

List one page of negative keywords for a campaign or ad group in an authorized advertiser account.

Get Showcase Products

Get one page of products available in a Showcase.

Get Showcase Regions

Get the regions targetable by a Showcase-bound identity.

Get Smart+ Ad Groups

List Smart+ ad group details through TikTok's dedicated /smart_plus/adgroup/get/ endpoint.

Get Smart+ Ads

List Smart+ ad details through TikTok's dedicated /smart_plus/ad/get/ endpoint.

Get Smart+ Campaigns

List Smart+ campaign details through TikTok's dedicated /smart_plus/campaign/get/ endpoint.

Get Trending Catalog Products

Get up to 50 trending products from an eligible E-commerce catalog.

List Trending Videos for Commercial Music

Retrieve the top trending TikTok videos that use a Commercial Music Library track in a selected region.

List Trending Commercial Music

Retrieve up to 100 popular, pre-cleared Commercial Music Library tracks for a TikTok Business Account, region, genre, and popularity window.

Get Trending Search Keywords

Get the top 20 TikTok search keywords, optionally personalized for a Business Account.

Set Search Ad Negative Keywords

Set negative keywords on Search Ads campaigns or ad groups.

Set Smart+ Delivery Status

Enable or disable up to 20 Smart+ campaigns, ad groups, or ads.

Share Creative Assets

Share controlled creative assets from one advertiser with specified target advertiser accounts.

Preview Smart+ Ad

Generate a preview link or iframe for a proposed or existing Upgraded Smart+ ad.

Submit UnionPay Verification

Submit identity and UnionPay account details to verify an eligible business license.

Unassign TikTok Account From Advertiser

Unlink a TikTok account from an ad account in the same Business Center.

Update Advertiser Account

Update one TikTok ad account's name, contact, company, license, certificate, promotion-link, address, or billing tax-number metadata.

Update Advertiser Budgets

Consequential financial action that updates, resets, increments, deducts, or sets minimum budgets for ad accounts in a Business Center.

Update Catalog

Update the name of a catalog owned by a TikTok Business Center.

Update Catalog Feed Schedule Status

Set one catalog feed schedule to ON or OFF.

Update GMV Max Campaign

Update supported fields on an existing GMV Max campaign; at least one field to update must be provided.

Update GMV Max Campaign Creatives

Remove creatives from a GMV Max campaign or add them back.

Update GMV Max Session

Update documented budget or schedule fields for a max delivery or creative boost session.

Update Pangle Block List

Update an advertiser's Pangle app block list by adding apps, removing apps, or clearing the existing list before adding replacements.

Update Search Ad Negative Keyword

Update the name or match type of one negative keyword attached to a Search Ads campaign or ad group.

Update Smart+ Ad

Update an existing Smart+ ad and its material configuration; at least one field to update must be provided.

Update Smart+ Ad Group

Update an existing Smart+ ad group's name, bid, budget, schedule, pacing, comment or sharing settings, and audience targeting.

Update Smart+ Ad Group Budgets

Update immediate total budgets or next-day scheduled daily budgets for Upgraded Smart+ ad groups.

Update Smart+ Ad Material Status

Enable or disable up to 20 materials belonging to a Smart+ ad.

Update Smart+ Campaign

Update an existing Smart+ campaign's supported fields; at least one field to update must be provided.

Upload Business Certificate Image

Upload a business certificate image for an ad account through a Business Center where the connected user is an administrator.

Upload Catalog Videos by File URL

Upload catalog videos from a file URL.

FAQ

Frequently asked questions

With a standalone TikTok Ads MCP server, the agents and LLMs can only access a fixed set of TikTok Ads tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from TikTok Ads and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right TikTok Ads tools.

Yes, absolutely. You can configure which TikTok Ads scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your TikTok Ads data and credentials are handled as safely as possible.

Start with TikTok Ads.It takes 30 seconds.

Managed auth, hosted MCP servers, and every TikTok Ads tool your agent needs.Free to start.

Start building