TikTok Ads MCP Server
Connect TikTok Ads to Claude, ChatGPT, or any MCP client
TikTok's official MCP server. Manage Upgraded Smart+ and GMV Max campaigns, pull performance reports, run catalogs, audiences and creatives, and administer Business Center — straight from a chat.
- 378 tools
- Official TikTok for Business server
- Sign in with TikTok for Business
- No API keys or developer app
TikTok is also in Claude's connector directory — search "TikTok" under Connectors. That version leaves out a few tools, such as finance management.
Requires a ChatGPT paid plan (Plus, Pro, or Business).
Add this to your claude_desktop_config.json:
{
"mcpServers": {
"tiktok-ads": {
"url": "https://business-api.tiktok.com/open_mcp/tt-ads-mcp-layer"
}
}
}Add this to your .cursor/mcp.json in your project root:
{
"mcpServers": {
"tiktok-ads": {
"url": "https://business-api.tiktok.com/open_mcp/tt-ads-mcp-layer"
}
}
}Run this command in your terminal:
claude mcp add tiktok-ads --transport http https://business-api.tiktok.com/open_mcp/tt-ads-mcp-layer
You will be prompted to sign in on first use.
Run this command in your terminal:
gemini mcp add tiktok-ads --transport http https://business-api.tiktok.com/open_mcp/tt-ads-mcp-layer
You will be prompted to sign in on first use.
Tools Reference
378 tools organized by category. Click any category to expand.
Get estimated audience size.
Create an ad.
Get all ads or use filters to get certain ads.
Get ad review information.
Update ad status.
Update an ad.
Appeal the rejection decision if your ad group was rejected during review.
Update ad group budget.
Get all ad groups or use filters to get certain ad groups.
Get the dynamic quota on active ad groups.
Get ad group review information.
Create R&F ad group.
Get estimated daily cost and frequency distribution.
Update R&F ad group.
Validate R&F contracts.
Get time zones based on country or region codes.
Get inventory estimates.
Cancel R&F ad order.
Update ad group status.
Create an ad group.
Update an ad group.
Get ad account balance and budget.
Get advertiser information such as account name, email and contacts.
Get transaction records of an ad account.
Update an ad account.
Get a list of advertisers that have granted you the permission to manage their accounts on their behalf.
Create a mobile App.
Obtain the details of an App.
Obtain the list of apps under your account
Obtain information about an app conversion event
Obtain information about an App Retargeting Event
Update a mobile App.
Get details of potential audiences.
Get details of audience overlap.
Apply audience to or disconnect audience from multiple ad groups.
Get the latest application log of custom audiences.
Create audience by file.
Delete an audience.
Get audience details.
Get all audiences.
Create lookalike audience.
Manually refresh a Lookalike Audience.
Create audience by rule.
Ad account owners, or users in Admin or Operator roles can share custom audiences with other advertisers.
Ad account owners, or users in Admin or Operator roles can stop sharing custom audiences with other advertisers.
Ad account owners, or users in Admin or Operator roles can get the sharing log of a custom audience.
Update details of an audience.
Create a Saved Audience.
Delete Saved Audiences.
Get the details of Saved Audiences.
Get the audience for Pangle placement.
Get Pangle block list.
Update Pangle block list.
You can use this endpoint to create or delete audience segments.
Understand how many ads an asset has been binded to, and how many more ads this asset can be binded to.
Get the budget change history of an ad account.
Get the cost records of a BC and ad accounts.
Get the transaction records of a BC or ad accounts
Get currencies and registration areas for ad accounts.
Create an ad account under a Business Center.
Disable ad accounts.
Get qualifications within a Business Center.
Check the UnionPay verification requirement for a business license.
Submit UnionPay verification for a business license.
Obtain a TikTok account ad delivery authorization URL.
Delete assets.
Get assets of a Business Center as admins.
Link a TikTok account to an ad account in Business Center.
Get ad accounts linked to a TikTok account in Business Center.
Unlink a TikTok account from an ad account in Business Center.
Assign assets to a user.
Get assets of a Business Center.
Get members by assets.
Get partners by assets.
Revoke the access to an asset from a user.
Create an Asset Group in your Business Center.
Remove members' access to an Asset Group.
Get the assets or members of an Asset Group in a Business Center.
Get all Asset Groups in your Business Center.
Update assets, members or the name of an Asset Group.
Get the balance of a Business Center.
Get all billing groups in a Business Center.
Create a billing group in a Business Center.
Get all billing groups in a Business Center.
Update settings of a billing group.
Get Business Centers that you have access to.
Finance Managers and Finance Analysts of a Business Center account can use this endpoint to get invoices of their Business Center accounts.
Create an asynchronous download task.
Check whether the asynchronous download task (BILLING_REPORT type) has completed.
Check whether the asynchronous download task (INVOICE_LIST or INVOICE_BATCH type) has completed.
Finance Managers and Finance Analysts of a Business Center account can use this endpoint to get total unpaid amount of their Business Center accounts.
Delete a member or revoke a member invitation.
Get BC members.
Invite members to BC.
Update member information.
Add partner to Business Center.
Cancel asset sharing.
Get partner assets.
Delete partner.
Get partners.
Use this endpoint to get a list of ad accounts that have been linked to the request pixel.
Use this endpoint to link and unlink pixel to advertiser accounts.
Transfer Pixel from Advertiser to BC.
Get translaction records of a Business Center.
Process payments (recharge money to or deduct money from an ad account in a Business Center.
Check if a list of words is blocked.
Add words to the block list.
Delete one or more blocked words.
Get the list of blocked words for an ad account.
Check the status of the export task.
Create a task to export blocked words.
Download the exported blocked words.
Replace a blocked word with another word.
Get the results of an asynchronous copy task for a Manual Campaign.
Create an asynchronous copy task for a Manual Campaign.
Create a campaign.
Get all campaigns or use filters to get certain campaigns.
Get the quota for an iOS 14 Dedicated Campaign per ad network.
Update campaign status.
Update a campaign.
the countries and regions that ads for a catalog can be delivered to.
If your catalogs are still under your ad account, use this endpoint to migrate them to your Business Center.
Create a catalog by specifying information such as name, targeted locations, and currency.
Delete a catalog.
Bind app or website event sources to a catalog in a Business Center.
Unbind event sources from a catalog.
Get event source binding information.
Create a feed.
Delete a feed.
Get all feeds or a particular feed.
Get the last 10 operations of a feed.
Update the schedule status of a feed
Update a feed.
Get all catalogs or a particular catalog.
Get trending catalog product categories.
Get filters for catalog product insights.
Get trending catalog products.
Get the lexicon for your catalog. A lexicon means a list of variables that you can use in ad texts when promoting your catalog.
Get the list of locations (country or region abbreviations) that are supported by Catalog API and the corresponding currencies for each location.
You can get the number of products in different audit status (approved, rejected, and processing) in a catalog.
Delete products in bulk.
Upload products via file URL.
Get a list of products in your product catalog.
Use this endpoint to find out if a product was uploaded or deleted successfully, and what to do if it failed.
Update products in bulk.
Upload products.
Create a product set by conditions.
Delete product sets.
Get product sets.
Get products in a product set.
Update a product set.
Use this endpoint to update the name of a catalog. The catalog must be under a Business Center.
Delete uploaded catalog videos.
Upload catalog videos via a file URL.
Get the uploaded catalog videos within a catalog.
Get the catalog video handling log.
Get video packages.
Get synchronous catalog product diagnostic information.
Get catalog event source diagnostic information.
Get catalog event trends and match rate.
Create an asynchronous download task for catalog product diagnostic information.
Download asynchronous catalog product diagnostic information.
Get the activity log of a Business Center.
Check whether a log download file has been completed or not.
Initiate a task to download change logs for an ad account based on the parameters that you specify.
Get the log file that has been downloaded.
For users who added comments to TikTok ads that are created by users linked to Customized User or TTBA types of identities, they can delete their own comments.
Get comments for your ads.
Reply to comments.
Get related comments.
Use this endpoint to change the status of a list of comments from public to hidden, or vice versa.
Get comment export status.
Create comment export task.
Download exported comments.
Preview an ad or a creative.
Delete creative assets.
Create a welcome message within an ad account.
Get welcome messages within an ad account.
You can get recommended CTAs that you can use to create or update your ads.
Edit an image according to the size you want as well as apply creative trimmings.
Create a portfolio.
Delete portfolios.
Get a portfolio by ID.
Get portfolios within an ad account.
Use smart text.
Use this endpoint to create a task to detect and fix video issues.
Use this endpoint to get smart fix task results.
Get CRM Event Sets.
Get the message event sets for ad creation.
Create a Custom Conversion.
Delete a Custom Conversion.
Get the details of a Custom Conversion.
Get Custom Conversions associated with an event source.
Update a Custom Conversion.
Get image information.
Search for image creative in an advertising account's material library.
Update image name.
Upload an image to the creative repository.
Get music list.
Upload music.
Check the names of files.
Upload a file.
Get video information.
Search for a video.
Update video name.
Upload a video.
Get suggested thumbnails.
Create a GMV Max Campaign.
Get the details of a GMV Max Campaign.
Create a max delivery or creative boost session.
Delete a max delivery or creative boost session.
Get details of max delivery or creative boost sessions.
Get max delivery or creative boost sessions within a campaign.
Update a max delivery or creative boost session.
Update a GMV Max Campaign.
Get the recommended GMV Max ROI target and budget.
Get GMV Max Campaigns.
Grant an ad account exclusive authorization for a TikTok Shop.
Get the TikTok Shop exclusive authorization status of an ad account.
Get identities for GMV Max Campaigns.
Check the occupancy of identities or products in Shopping Ads
Run a GMV Max Campaign report.
Get TikTok Shops for GMV Max Campaigns.
Check the availability of a TikTok Shop for Product GMV Max Campaigns.
Get posts for a Product GMV Max Campaign.
Remove or add back creatives in a GMV Max Campaign
Get the identity list.
Get info about an identity.
Get live videos under an identity.
Get music authorization info of a video.
Get videos under an identity.
Get info about TikTok posts.
Get fields of an Instant Form or direct message leads.
Get an Instant Form lead or a direct message lead.
Create a new Offline Event set.
Delete an Offline Event set.
Get Offline Event sets.
Update an Offline Event set.
Bind objects to rules.
Create an automated rule.
Get rules by rule IDs.
Get rules based on the values of certain filters.
Get result details.
Get rule results.
Update an automated rule.
Turn on, turn off, or delete a group of rules.
You can use this endpoint to get the fields of an instant page.
Get the page ID.
Create lead download task.
Get form libraries.
Migrate leads to Business Center.
Get ad accounts linked to a Payment Portfolio.
Link ad accounts to a Payment Portfolio.
Create a Payment Portfolio.
Allocate the credit line to Payment Portfolios.
Get Payment Portfolios.
Get authorized users for a Payment Portfolio.
Create a Pixel.
Choose either an industry or custom template to define your events.
Delete Pixel events.
Update the name of a Pixel event and the conversion value.
Get the supported events for Instant Pages based on your objective types and optimization goals.
Obtain a list of Pixel information.
Update a Pixel.
Use this endpoint to get a list of playables.
Use this endpoint to save a playable.
Check the status of the playable.
Use this endpoint to run a report of creative assets.
Use this endpoint to get benchmarks about the performance of an ad.
Run an integrated report to get data about ad spend and performance, audience data, playable ads, or DSA. This is a GET request to get synchronous reporting data only.
Cancel an asynchronous report task
Check the status of an asynchronous report task.
Create a standard (synchronous) report and an asynchrounous report.
Download the data of an asynchronous report.
Get in-second performance data about a video.
Create negative keywords.
Delete negative keywords.
Get negative keywords.
Update a negative keyword.
Get identities with Showcase permission under an ad account.
Get the available products in a Showcase.
Get the available regions for a Showcase via identity.
Appeal rejection of an Upgraded Smart+ Ad.
Create an Upgraded Smart+ Ad.
Get Upgraded Smart+ Ads.
Disable or enable creatives in an Upgraded Smart+ Ad.
Preview Upgraded Smart+ Ads.
Get the review info of Upgraded Smart+ Ads.
Update the operation statuses of Upgraded Smart+ Ads.
Update an Upgraded Smart+ Ad.
Update the budgets of Upgraded Smart+ Ad Groups.
Create an Upgraded Smart+ Ad Group.
Get Upgraded Smart+ Ad Groups.
Update the operation statuses of Upgraded Smart+ Ad Groups.
Update an Upgraded Smart+ Ad Group.
Create an Upgraded Smart+ Campaign.
Get Upgraded Smart+ Campaigns.
Update the operation statuses of Upgraded Smart+ Campaigns.
Update an Upgraded Smart+ Campaign.
Get the review info of Upgraded Smart+ Ad creatives.
Run an Upgraded Smart+ Creative Breakdown Report.
Run an Upgraded Smart+ Creative Overview Report.
Get Spark Ads video recommendations for a TTO account.
Create a split test.
End a split test.
Run the winning ad group.
Get split test results.
Update split test time.
Get available stores under an ad account.
Get products within a store.
Get subscriptions.
Create a subscription.
Cancel subscription.
This interface confirms the signing status of an agreement.
Use this endpoint to sign the agreement for the Lead Generation Ads feature.
Get agreements (terms) that you need to sign before you can use certain features.
Get the campaign labels of an ad account.
Get the TikTok Minis within an ad account.
Get available locations based on advertiser ID.
Get a suggested bid value for your ad group based on basic campaign and ad group settings like objectives, conversion events, and locations.
Get diagnosis, including possible issues and suggestions for correction or improvements, for your active ad groups.
Get Search Ads Campaign Health diagnoses.
Get TikTok in-app links.
Discover new keywords.
Get recommended search keywords.
Get time zones.
Get the verification results of a URL.
Check Value-Based Optimization eligibility.
Get languages.
Get OS versions.
Get region calling codes and region codes for phone numbers.
Get available locations based on different settings.
Search for or list targeting categories and hashtags for interests and behaviors.
Get the Brand Safety Hub settings of an ad account.
Set or update the Brand Safety Hub settings of an ad account.
Get action categories.
Get Brand Safety partner authorization status.
Get carriers.
Get available content exclusion categories.
Get info of content exclusion categories.
Get available contextual tags.
Get info of contextual tags.
Get device models.
Get targeting hashtags by ID.
Search for targeting hashtags.
Get general interest categories.
Get additional interest categories by ID.
Search for additional interest categories.
Obtain details about location targeting tags by ID.
Get internet service providers.
Search for location targeting tags.
Get recommended interest and action categories based on historical performance data in the same industries.
Apply authorization code.
Get Spark Ad post.
Get Spark Ad posts.
Unbind Spark Ad post.
Get authorized user by access token.
The AOS diagnosis agent is the official advertising diagnosis agent for TikTok ads. It operates as an A2A (Agent-to-Agent) tool that an arbitrary agent can invoke to troubleshoot performance issues for any non-GMV Max TikTok ad account, campaign, or ad group. The tool outputs its findings in natural language, allowing it to seamlessly supplement your hosting agent's own analysis.
Authentication
This is TikTok's own server, so you sign in with your TikTok for Business account (OAuth 2.0). Your AI client talks to TikTok directly — there is no developer app to register and no API key to copy.
- Your MCP client connects to TikTok's server
- You sign in to TikTok Ads Manager, if you aren't already
- You review the permissions and click Authorize
- Access lasts 30 days, then you authorize again with the same account
Good to Know
- The URL above is TikTok's Progressive Disclosure server: about 40 core tools load when you connect and the rest load when needed, so your client is never handed hundreds of tools at once.
- Each tool takes up to 3 calls per second per TikTok for Business user.
- Change a single Upgraded Smart+ ad at most once every 5 seconds, or TikTok returns a concurrency error.
- Which tools you can use varies by region and account setup.
What to Ask
Once connected, talk to your AI assistant in plain language. Here are some things you can ask:
Ready to connect?
Add the endpoint to your MCP client and sign in with your TikTok for Business account.
Other MCP servers
Microsoft Advertising MCP Server
Connect Claude or any MCP client to Microsoft Advertising. Manage campaigns, pull reports and optimize Bing Ads in plain English. Free MCP by Adcore.
Google Ads MCP Server
Connect Claude or any MCP client to Google Ads. Analyze performance, manage campaigns and automate optimizations in plain English. Free MCP by Adcore.
Meta Ads MCP Server (Facebook & Instagram)
Connect Claude or any MCP client to Meta Ads. Report on Facebook and Instagram campaigns and optimize performance in plain English. Official Meta MCP.