TikTok Ads MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with TikTok Ads MCP or direct API to read advertisers, manage campaigns and ad groups, create and share creatives, and retrieve performance reports through natural language.

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

Try TikTok Ads now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
TikTok Ads
Try asking
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.

SETUP GUIDE

Connect TikTok Ads MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["tiktok_ads"],
  mcp: true,
});
Create a session scoped to TikTok Ads and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "List all active campaigns with spend",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a TikTok Ads request
SETUP GUIDE

Connect TikTok Ads API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["tiktok_ads"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to TikTok Ads
3

Run TikTok Ads tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "List all active campaigns with spend" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the TikTok Ads tool calls through the session, and print the final answer

Why Use Composio?

AI Native TikTok Ads Integration

  • Supports both TikTok Ads MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your TikTok Ads data

Managed Auth

  • Built-in OAuth handling with automatic token refresh and rotation
  • Central place to manage, scope, and revoke TikTok Ads access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access TikTok Ads
  • Scoped, least privilege access to TikTok Ads resources
  • Full audit trail of agent actions to support review and compliance

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

TikTok Ads requires connections to go through your own OAuth app. You register it once with TikTok Ads, add its client ID and secret in the Composio dashboard, and from then on everyone connects by signing in to TikTok Ads as usual. Composio handles the rest of the flow and the token refresh.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Yes. Composio is SOC 2 Type II compliant and is built to keep your TikTok Ads connection and credentials secure. OAuth tokens and API keys are encrypted, and sensitive customer data is protected at rest and in transit.

Composio also undergoes independent security testing and continuously monitors its systems for security threats. You can review the latest reports and policies in the Composio Trust Center.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

When you connect a TikTok Ads account through Composio, every action runs under that account, so anything the agent creates, sends, or changes shows up in TikTok Ads as done by you. Keep an approval step in your prompt for actions with side effects, such as sending or deleting, and have the agent draft first.

Exactly the ones TikTok Ads lists on its consent screen when you connect. Review that screen before approving. If you connect a work account, your TikTok Ads administrator may need to approve the app first, and you can revoke the access inside TikTok Ads whenever you want.

Yes. Composio supports multiple connected accounts for the same app, and that works in Claude, ChatGPT, or any other assistant you connect through Composio. Give each TikTok Ads connection a name such as work or personal, and the assistant uses the one you mention in the request. Each account keeps its own credentials and nothing is merged.

Composio refreshes TikTok Ads tokens automatically, so day to day you do nothing. If you revoke access inside TikTok Ads, or TikTok Ads invalidates the session, the connection shows as expired in Composio and the agent stops acting on that account until you reconnect it, which is a single sign-in.

Composio's free Hobby plan includes 100,000 tool calls per month with no credit card, which covers most personal TikTok Ads use. Paid plans add higher limits and team features. Your TikTok Ads plan and its API limits still apply as usual.

Built-in connectors usually give one AI access to a limited set of apps. Many people use Composio because it lets their AI connect to more apps than it normally supports, or connect to multiple accounts for the same app (e.g. connect Claude to multiple TikTok Ads accounts).

With Composio, you connect TikTok Ads once and then use it across different AI assistants without setting it up separately in each one. Connect your apps to Composio once, then connect Composio to whichever AI you use, whether that's Claude, ChatGPT, Hermes, or your own custom assistant.

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