TikTok Ads

Platform Overview

The TikTok Ads MCP server enables AI assistants to read and analyze TikTok short-form video advertising campaigns, creatives, and performance data. It integrates with TikTok's Marketing API to help users monitor campaign performance, explore audience demographics, review creative metrics, and manage their advertising hierarchy across multiple advertiser accounts.

Your prompt → Claude + Hopkin → TikTok Marketing API v1.3
                                    ↓
                              Advertiser Accounts
                              Campaign Data
                              Ad Groups & Ads
                              Video Performance
                              Audience Demographics
                              Creative Metrics

Common Workflows

Performance Reporting

"Show me how my TikTok campaigns performed over the last 7 days."

Uses tiktok_ads_get_performance_report with date preset "last_7d" and level "campaign". Returns spend, impressions, clicks, conversions, and engagement metrics aggregated by campaign and day.

"Break down my ad group performance by age group and country to see which demographics convert best."

Uses tiktok_ads_get_insights with data_level "AUCTION_ADGROUP", report_type "AUDIENCE", and dimensions ["age_group", "country"]. Returns demographic breakdowns with conversion and cost metrics.

"What are the video completion rates for my ads over the past 30 days?"

Uses tiktok_ads_get_creative_report with date preset "last_30d". Returns video watch metrics including p25/p50/p75/p100 completion rates, video views, and average watch time per creative.

Campaign Management

"List all my TikTok advertiser accounts."

Uses tiktok_ads_list_advertisers to fetch all accessible advertiser accounts with status, currency, and timezone info. Returns cached results with sync timestamp.

"Show me all active campaigns for advertiser ID 12345."

Uses tiktok_ads_list_campaigns with advertiser_id "12345" and status filter ["STATUS_ON"]. Returns campaign names, objectives, budgets, and budget modes.

"Get the details of a specific ad group and its associated ads."

Uses tiktok_ads_get_ad_group to fetch ad group details, then tiktok_ads_list_ads with the ad_group_id filter to list all ads in that group. Shows targeting, budget, optimization goal, and ad-level status.

Video & Creative Analysis

"Which videos in my campaigns are getting the most engagement?"

Uses tiktok_ads_get_creative_report to fetch ad-level metrics including video_play_actions, impressions, and spend. Returns per-creative breakdowns sorted by engagement.

"Show me a preview of the creatives in my top-performing campaign with their engagement metrics overlaid."

Uses tiktok_ads_preview_ads with ad IDs and custom metrics (e.g., impressions, clicks) to render visual previews of TikTok ads with configurable metric labels in an interactive UI.

"What's the audience split for my ad group by placement (Feed vs Explore)?"

Uses tiktok_ads_get_insights with dimensions ["placement"] and data_level "AUCTION_ADGROUP" to break down performance by where ads appear on TikTok.

Recipes

"I need a comprehensive performance summary of my TikTok account. List all my campaigns, show overall metrics for the last 14 days, and break down spend by ad group."

Calls tiktok_ads_list_campaigns to enumerate campaigns, then tiktok_ads_get_performance_report with level "adgroup" and date_preset "last_14d" to fetch granular spend, impressions, and conversion metrics for each ad group across all campaigns.

"Compare the video completion rates of my three best campaigns to identify which creative style resonates most with viewers."

Uses tiktok_ads_list_campaigns to fetch all campaigns, then calls tiktok_ads_get_creative_report with each campaign_id filtered to get ad-level video metrics (p25/p50/p75/p100 completion rates). Compares average completion rates across the three campaigns to find the pattern.

"I want to audit which audiences are delivering the best ROI. Show me a demographic breakdown (age, gender, country) of spend and conversions for my ad groups."

Uses tiktok_ads_list_ad_groups to get ad group IDs, then calls tiktok_ads_get_insights with data_level "AUCTION_ADGROUP", report_type "AUDIENCE", and dimensions ["age_group", "gender", "country"] to return spend, conversion, and cost_per_conversion for each demographic segment.

"Create a visual report of my top-performing ads with their video metrics embedded as overlays."

Uses tiktok_ads_get_creative_report to fetch ad IDs and their video metrics (impressions, video_play_actions, completion rates), then calls tiktok_ads_preview_ads with those ad IDs and metrics to render interactive previews showing creative content with performance data.

"I need to investigate why one of my campaigns underperformed. Show me the campaign details, all ad groups within it, and the daily performance trend for the past 30 days."

Uses tiktok_ads_get_campaign to fetch campaign metadata, tiktok_ads_list_ad_groups with campaign_ids filter to list ad groups, then tiktok_ads_get_performance_report with level "campaign", the campaign_id, date range for 30 days, and dimensions ["stat_time_day"] to show daily spend/impressions/conversions trends.

"I want to check my auth status and verify I have access to all my TikTok advertiser accounts."

Uses tiktok_ads_check_auth_status to verify the connection and auth method, then tiktok_ads_get_user_info to see the authenticated user's profile (email, role), and finally tiktok_ads_list_advertisers to confirm all accessible advertiser accounts are visible.

Tips

• Always provide advertiser_id for most operations: TikTok requires an advertiser ID (equivalent to Meta's ad account or Google's customer ID) for nearly every API call. Use tiktok_ads_list_advertisers first if you don't know the ID, or ask the user for it.

• Video-specific metrics are in the creative report: If you need completion rates, video play actions, or watch-time metrics, use tiktok_ads_get_creative_report instead of tiktok_ads_get_performance_report. The creative report returns TikTok-specific video engagement data with p25/p50/p75/p100 watch percentages.

• Use insights with dimensions for flexible analysis: tiktok_ads_get_insights accepts custom dimension arrays (age_group, gender, country, placement, stat_time_day) and report types (BASIC vs AUDIENCE), making it ideal for demographic breakdowns and flexible pivoting. Performance reports are fixed to campaign/adgroup/ad levels and standard metrics.

• Cached data refreshes in the background: List operations (campaigns, ad groups, ads, audiences) return cached data with a cached: true flag and synced_at timestamp. Pass refresh: true if you need a synchronous fetch, but background refresh is automatic for non-refresh calls—results update without blocking.