Peter Grafe
TikTok Skills in Claude: The BlueAlpha Marketing Plugin
Nine agent skills that turn TikTok Ads data into audits, creative fatigue detection, audience tier maps, and incrementality tests inside Claude.
The BlueAlpha Marketing Plugin for TikTok puts nine specialized marketing agent skills inside Claude via MCP (Model Context Protocol). Each skill connects directly to the TikTok Marketing API to run account audits, detect creative fatigue through leading indicators, build audience tier maps with iOS SKAdNetwork attribution-completeness scoring, design geo-based incrementality tests, and produce deployment-ready campaign specs. The system follows BlueAlpha's five-step loop (Analyze, Decide, Plan, Act, Prove) and cross-references a Bayesian MMM when connected, validating TikTok platform ROAS against causal incrementality data. No dashboards, no exports, no manual data prep.
Most TikTok advertisers suspect their platform-reported numbers are wrong. For iOS app campaigns, 60-80% of conversions land in SKAdNetwork's anonymous bucket, meaning the demographic and geographic data TikTok shows you represents a fraction of your actual conversion volume. The BlueAlpha TikTok skills surface this gap explicitly: every audience read includes an attribution-completeness score so you know whether you're acting on 20% or 80% of your data.
Every TikTok advertiser hits the same wall. The platform UI tells you what happened. It doesn't tell you what to do next. You end up with a dozen tabs open: campaign manager, creative library, audience insights, a spreadsheet someone built last quarter, trying to synthesize a decision that should take ten minutes.
The BlueAlpha TikTok skills close that gap. Claude connects directly to your TikTok Ads account via MCP (Model Context Protocol), pulls the data, runs the analysis, and returns a structured recommendation inside the conversation. You don't export anything. You don't copy-paste numbers. You type a prompt and get back a decision.
All 9 TikTok skills in the BlueAlpha Marketing Plugin
Account health & optimization
tiktok-auto-optimizetiktok-full-monty
Creative performance
tiktok-creative-fatigue-watchdogtiktok-creative-refresh
Audience & targeting
tiktok-audience-intelligencetiktok-geo-expansiontiktok-incrementality-test
Campaign creation
tiktok-content-to-campaign
Reporting
tiktok-performance-digest
The Analyze → Decide → Plan → Act → Prove Loop for TikTok Ads
Every BlueAlpha skill follows the same five-step pattern:
1. Analyze. Claude calls the TikTok Ads API directly through MCP. No manual exports, no copy-paste. It pulls campaigns, adgroups, creative metrics, audience delivery reports, and interest category taxonomies in real time.
2. Decide. The skill applies BlueAlpha's decision logic: efficiency scores, severity tiers, attribution completeness gauges, spend waste estimates. You get a tier map (Gold/Silver/Bronze/Cut or Critical/High/Moderate/Healthy), not a data dump.
3. Plan. The skill builds a prioritized execution plan with sequencing, dependencies, and risk gates. Budget reallocations get a timeline. Creative refreshes get a brief. Tests get a pre-registered design.
4. Act. Every output ends with a three-bucket action plan: Auto-approve (safe to execute now), Recommend (needs a quick review), Needs discussion (bigger structural moves). You know exactly what to do and in what order.
5. Prove. Post-execution, the skill tracks whether the change produced the expected lift. For incrementality tests, this means statistical significance testing. For budget moves, it means comparing pre/post performance. The proof feeds back into the next Analyze cycle.
Who Should Use the BlueAlpha TikTok Plugin?
Performance marketers running TikTok spend above $10K/month who want a faster weekly optimization cycle
Media buyers managing multiple accounts who need a structured read without manually pulling reports
Growth leads who own the full funnel and need to tie TikTok creative health back to CPA trends
Agency teams who want to show clients a clear, documented optimization rationale, not just a screenshot of the dashboard
BlueAlpha delivers the plugin through forward-deployed engineering. A senior growth partner embeds with your team, builds the measurement and execution stack directly, and trains your team to run the agents independently. You keep the seat. The agents eliminate the hours. The knowledge base stays yours.
How to pick the right skill
If you want to… | Use this skill |
|---|---|
Get a full account health check in one shot |
|
Find out which creatives are dying before CTR drops |
|
Get a brief for net-new creative based on what's working |
|
Understand who's actually converting (age, geo, placement) |
|
Identify new geos to test |
|
Validate that TikTok is driving real incremental revenue |
|
Send leadership a weekly TikTok performance narrative |
|
Turn a blog post or content piece into a TikTok campaign spec |
|
Run everything at once |
|
How Does the BlueAlpha Marketing Plugin Connect to TikTok Ads?
Every skill in the BlueAlpha Marketing Plugin is backed by an MCP connector that gives Claude direct, permissioned access to the TikTok Marketing API. MCP-native means the whole system lives inside Claude, Codex, or any AI workspace your team already uses. No separate login, no dashboard to check. The decision lives where the conversation happens, not in a separate dashboard you check after the fact.
The BlueAlpha TikTok connector gives Claude the ability to:
Pull campaigns, adgroups, ads, and creative-level performance with full breakdown support
Audit account structure and score every campaign on objective alignment, pacing, and creative health
Compute hook rate, hold rate, and completion rate trends across the active creative set
Calculate iOS SKAdNetwork attribution completeness and flag confidence levels on demographic reads
Pull AUDIENCE reports across age, gender, placements, DMAs, provinces, and interest categories
Identify expansion-candidate geos using TikTok's targeting taxonomy
Design geo-split incrementality tests with matched controls and MDE calculation
Where relevant, skills also cross-reference a Meridian MMM (marketing mix model) via the BlueAlpha MMM connector to validate TikTok platform ROAS against causal incrementality data. The MMM is optional. Every skill works without it, but the recommendations get sharper when causal measurement is underneath.
TikTok announced its own official TikTok Ads MCP server at TikTok World in May 2026, which validates the category. That server is positioned as infrastructure for letting external AI agents run campaigns autonomously: setting bids, adjusting budgets, modifying targeting, creating ad assets. The BlueAlpha plugin sits at a different layer. It ships nine TikTok-specific skills that turn API access into decisions: full-account audit with severity tiers, leading-indicator creative fatigue detection, attribution-completeness scoring, audience tier maps with explicit confidence levels, geo expansion analysis, incrementality test design, and content-to-campaign activation. Setup is also different. The BlueAlpha connector handles authentication behind a single sign-in: no developer token, no OAuth configuration, no token refresh management.
How Do I Install the BlueAlpha Marketing Plugin?
There are two pieces to install: the BlueAlpha MCP connector (so Claude can read your TikTok Ads data and your Meridian MMM) and the BlueAlpha Marketing Plugin itself (the nine TikTok skills that put that data to work). Total setup time is about a minute. Steps 1 and 3 are the same regardless of which Claude product you use; Step 2 has two paths depending on whether you're in Cowork or Claude Code.
Step 1: Install the BlueAlpha MCP connector
Open Settings in the Claude desktop app
Go to Connectors → Add custom connector
Name it:
BlueAlpha MCPURL:
https://mcp.bluealpha.ai/mcpClick Connect and sign in with your BlueAlpha account
That single sign-in wires Claude up to your TikTok Ads accounts (and your Meridian MMM, if you have one). No keys, no IDs, no config files.
Step 2: Install the plugin
Pick the path that matches the Claude product you're using.
Option A: Cowork (drag-and-drop)
Click Releases on the right rail and open the latest release
Expand Assets and click
bluealpha-marketing-plugin.pluginto downloadDrag the downloaded file into an open Cowork session and click Install when prompted
That's it. No CLI, no settings menu. One drag.
Option B: Claude Code (slash commands)
Inside Claude Code, run these two commands:
/plugin marketplace add <https://github.com/bluealpha-labs/bluealpha-mcp-plugins.git> /plugin install bluealpha-marketing-plugin
/plugin marketplace add <https://github.com/bluealpha-labs/bluealpha-mcp-plugins.git> /plugin install bluealpha-marketing-plugin
The first registers the GitHub repo as a marketplace; the second installs the plugin from it.
Step 3: Try a skill
Invoking a skill is as simple as typing something like:
"Run tiktok-auto-optimize on my TikTok account, last 14 days, moderate risk tolerance."
Claude will route that to the right skill, load the workflow, and walk you through the Analyze → Decide → Plan → Act → Prove loop.
TikTok Skill Reference: Example Prompts and Outputs
tiktok-auto-optimize
/tiktok-auto-optimize or optimize my TikTok account
Runs a complete optimization cycle across your entire TikTok account. It audits campaign and adgroup structure (naming, objective alignment, budget mode), diagnoses pacing and underspend, identifies budget reallocation opportunities, assesses creative health across the top 10 adgroups, and compiles a risk-tiered action plan. The output separates what you can approve immediately from what needs a conversation.
Real example, FinTech Co (iOS app, $11K daily budget): Auto-Optimize pulled all 5 active campaigns and immediately flagged $981/day in underspend. The root cause was not budget. It was ADGROUP_STATUS_REVIEW_PARTIALLY_APPROVEDon Pangle and Lemon8 placements, a restriction TikTok applies to financial services advertisers in the credit category. Two Checkout campaigns were pacing at 76–77% as a result. The skill scored every campaign (iOS-Creative Test led at 90/100, scale-ready), mapped budget reallocation to the three best-performing adgroups, and delivered 8 action items sorted by risk: 3 auto-approve, 2 recommend, 3 needs discussion. The whole run (live API calls, analysis, output) took under 90 seconds inside Claude.
tiktok-creative-fatigue-watchdog
/tiktok-creative-fatigue-watchdog or check my TikTok creatives for fatigue — last 14 days
Pulls the top 100 creatives by spend for a 14-day recent window and a prior 14-day window, then computes hook rate (video_views_p25 / impressions), hold rate (video_views_p50 / impressions), and completion rate for each. It calculates trend deltas — how much each signal has decayed — and classifies every creative into four severity tiers: Critical, High, Moderate, or Healthy. The output includes a wasted spend estimate, a prioritized refresh queue, and a healthy creative profile that feeds directly into tiktok-creative-refresh.
Hook rate leads CTR by 3–5 days. By the time you see CTR fall in the TikTok dashboard, you've already burned 4–5 days of spend.
Real example, FinTech Co (14 active creatives, $56K 14d spend): The Watchdog found 5 High-severity creatives and 3 Moderate. Creator Clip 142 was the standout: 55.6% hook rate, $41.50 CPA, the account benchmark. Total estimated wasted spend from High-tier decay: ~$2,100/week. Creator Clip 433, the top spender at $7,587 over 14 days, showed hold rate declining -25.3% from the prior window. Early decay in the highest-spend asset, exactly the kind of signal that's invisible in the TikTok UI until it's too late.
tiktok-creative-refresh
/tiktok-creative-refresh or generate a creative refresh brief based on my fatigue watchdog results
Takes the output of the Fatigue Watchdog (or runs it fresh) and turns it into a production-ready creative brief. It extracts the winning attributes from Healthy-tier creatives (hook style, format, video length proxy, CTA patterns) and uses them as the brief foundation. Output includes 3–5 new creative concepts with hook directions, suggested formats (UGC vs. studio), length targets, and music/sound notes, plus a test budget and timeline per concept.
tiktok-audience-intelligence
/tiktok-audience-intelligence or run audience intelligence on my TikTok account — last 30 days
Pulls the TikTok AUDIENCE report across all key dimensions (age × gender, placements, DMAs, provinces, interest categories, and connection type) and builds a tier map for each. Before scoring, it computes the iOS SKAdNetwork attribution completeness: the share of conversions TikTok can attribute to a specific demographic vs. the "NONE/Unknown" bucket. For iOS app-promotion accounts, this often runs below 30%. The skill is explicit about confidence levels: >70% = act on it, 40–70% = directional, <40% = run an incrementality test before making demographic exclusions.
Real example, FinTech Co (iOS app, 30-day window): Attribution completeness came in at 19.6%, meaning 80.4% of conversions landed in the SKAdNetwork unknown bucket. The demographic tier map was flagged as directional only. That said, the signal was clear: Male 18–24 (Gold, $111 CPA) and Male 25–34 (Gold, $115 CPA, 618 device-attributed conversions) were the top performers. Cut-tier segments (Female 55+, Male 55+, Male 45–54, Female 45–54) represented an estimated $14,675/week in wasted spend. The geo read was strong: Chicago ($41.75 CPA), New York ($43.15), and Miami ($45.61) led the DMA tier map. WiFi users converted at $146 CPA vs. $174 for 4G, a 16% gap consistent with at-home, planning-mode financial app sign-ups.
tiktok-geo-expansion
/tiktok-geo-expansion or identify new geographic markets worth testing on TikTok
Analyzes current geo performance across countries, DMAs, and provinces, then cross-references with TikTok's targeting taxonomy to identify expansion candidates. It segments existing geos into Proven (strong CPA, high volume), Exploratory (decent CPA, low volume, worth scaling), Untested (available in TikTok targeting but no current spend), and Poor (cut). Output is a ranked expansion shortlist with suggested test budgets, estimated audience sizes, and a test timeline.
tiktok-incrementality-test
/tiktok-incrementality-test or design a geo-based incrementality test for TikTok — 4-week holdout
Designs a geo-split holdout test to measure true incremental lift from TikTok spend. It selects matched test and control DMAs based on historical conversion similarity, calculates the minimum detectable effect for your budget and timeline, and produces a pre-registered test plan with integrity checks. After the test runs, it reads the results, applies statistical significance testing, and gives you a calibrated CPA you can trust, not the platform-reported number.
tiktok-performance-digest
/tiktok-performance-digest or generate my weekly TikTok performance digest
Produces a weekly (or monthly) performance narrative in the BlueAlpha format: what happened, what drove it, and what to watch. It pulls 7-day and 30-day campaign, creative, and audience trends, identifies the top movers (up and down), flags any anomalies, and writes a 3–4 paragraph executive summary alongside a structured metrics table. Designed to be copy-pasted directly into a Slack update or client report.
tiktok-content-to-campaign
/tiktok-content-to-campaign or promote this blog post as a TikTok campaign — build the full spec
Turns any content piece (a blog post, product launch announcement, organic TikTok video, or news item) into a complete paid campaign spec. Claude reads the content, extracts the core angle and value proposition, and builds a production-ready output: campaign objective, audience tiers (core, broad, retarget), placement settings, creative brief (hook direction, body, close, visual style), KPIs, daily budget, and a pause rule for the test window. The output goes directly to a media buyer or creative team. No reformatting needed.
tiktok-full-monty
/tiktok-full-monty or run the full TikTok analysis on my account
Runs 5 skills in sequence: Auto-Optimize → Creative Fatigue Watchdog → Audience Intelligence → Geo Expansion → Performance Digest. Produces a single unified report with cross-skill callouts. For example, when a fatigued creative clusters in a high-performing demographic, or when a Cut-tier DMA is receiving budget that could flow to an Exploratory geo. Use this for quarterly account reviews or onboarding a new account.
Why BlueAlpha Skills Beat TikTok’s Built-In Optimization
TikTok’s native tools (Smart+ autopilot, automated rules, audience insights) are designed to optimize within the platform's own attribution model and toward TikTok's objective (more spend, more reported conversions). They're useful, but they have three structural limits:
They can't see across channels. TikTok's tools only know about TikTok. BlueAlpha skills can cross-reference your TikTok audience tier map against a Meridian MMM in the same session. When a Gold-tier demographic looks efficient on platform CPA, you can immediately check whether TikTok-as-a-channel is actually driving incremental revenue or just claiming credit.
They don't surface what they can't attribute. The iOS SKAdNetwork attribution gap is real and systematic. For iOS app advertisers, 60–80% of conversions land in anonymous buckets. TikTok's built-in audience insights quietly excludes these and shows you clean-looking demographic data. The Audience Intelligence skill explicitly computes attribution completeness and flags confidence levels so you know whether the demographic read you're acting on represents 20% or 80% of your actual conversion volume.
They optimize for metrics, not decisions. Auto-Optimize found $981/day in underspend. The root cause was not a budget issue. It was a platform restriction (ADGROUP_STATUS_REVIEW_PARTIALLY_APPROVED) on Pangle placements for financial services advertisers. TikTok's automated rules would have suggested increasing budgets. The BlueAlpha skill identified the actual constraint and recommended a targeted fix: redirect the stranded budget to the iOS-CT Alpha adgroup, which had a $30.18 CPA and room to scale.
How BlueAlpha Runs Your TikTok Budget Like a Portfolio
BlueAlpha runs your TikTok budget like a portfolio position: measured causally, rebalanced toward what works, and executed across platforms. Causal measurement sits underneath every recommendation. MCP-native agents produce deployment-ready specs. A forward-deployed growth partner makes sure the system gets sharper every week.
The result: your team runs TikTok the way a portfolio manager runs capital. Every dollar is proven, every decision is auditable, and the agents eliminate the analytical hours that used to eat your week. The same connector powers BlueAlpha's Google Ads, Meta Ads, and LinkedIn Ads skill families. For a side-by-side comparison of all MCP servers for performance marketing, see 11 MCP Servers Reviewed. To see the full platform, book a walkthrough.
FAQ
Will the skills make changes to my TikTok account automatically?
No. All skills are read-only by default. The action plan output tells you what to do, but nothing is executed until you explicitly confirm. Write actions (pausing ads, adjusting budgets) are in the roadmap for a future plugin version.
How does the iOS SKAdNetwork attribution gap affect the analysis?
For iOS app-promotion campaigns, TikTok uses SKAdNetwork to report conversions on Apple devices. These conversions arrive without device-level signal (no age, no gender, no DMA), so they land in "Unknown" buckets. The Audience Intelligence skill measures what percentage of your conversions are device-attributed vs. unknown. Below 40% completeness, the demographic tier map is unreliable for making exclusion decisions. The skill will flag this and recommend a geo-split incrementality test instead.
Can I run the skills on multiple TikTok accounts?
Yes. The MCP connector surfaces all advertiser accounts associated with your Business Center login. When you run a skill, Claude will list available advertisers and ask you to confirm which one to analyze.
How often should I run each skill?
Auto-Optimize: weekly, or before any significant budget change. Creative Fatigue Watchdog: weekly for accounts spending >$50K/month on TikTok, bi-weekly for $10K–$50K, monthly below that. Audience Intelligence: monthly, or after any major campaign structure change. Performance Digest: weekly. Full Monty: quarterly.
What can the BlueAlpha plugin do that TikTok's official MCP can't?
TikTok's official MCP server (announced at TikTok World in May 2026) opens TikTok Ads Manager to external AI agents for autonomous campaign management (setting bids, adjusting budgets, modifying targeting, creating ad assets). That server is infrastructure for letting an agent run a campaign. The BlueAlpha plugin sits at a different layer. It ships nine TikTok-specific skills that turn API access into decisions: full-account audit with severity tiers, leading-indicator creative fatigue detection, iOS SKAdNetwork attribution-completeness scoring, audience tier maps with explicit confidence levels, geo expansion analysis, incrementality test design with statistical significance testing, and content-to-campaign activation. The BlueAlpha connector also handles authentication behind a single sign-in: no developer token, no OAuth configuration, no token refresh management.
Your Next Step: Run Your First TikTok Audit
If you have the BlueAlpha Marketing Plugin installed, run:
If you don't have the plugin yet, install it from the Cowork plugin marketplace and connect your TikTok Ads account in Settings, Connectors. The first Auto-Optimize run on a live account typically surfaces 3–5 actionable items within 2 minutes.
Questions? Book a demo or find us on the Cowork plugin marketplace.
The BlueAlpha Marketing Plugin for TikTok puts nine specialized marketing agent skills inside Claude via MCP (Model Context Protocol). Each skill connects directly to the TikTok Marketing API to run account audits, detect creative fatigue through leading indicators, build audience tier maps with iOS SKAdNetwork attribution-completeness scoring, design geo-based incrementality tests, and produce deployment-ready campaign specs. The system follows BlueAlpha's five-step loop (Analyze, Decide, Plan, Act, Prove) and cross-references a Bayesian MMM when connected, validating TikTok platform ROAS against causal incrementality data. No dashboards, no exports, no manual data prep.
Most TikTok advertisers suspect their platform-reported numbers are wrong. For iOS app campaigns, 60-80% of conversions land in SKAdNetwork's anonymous bucket, meaning the demographic and geographic data TikTok shows you represents a fraction of your actual conversion volume. The BlueAlpha TikTok skills surface this gap explicitly: every audience read includes an attribution-completeness score so you know whether you're acting on 20% or 80% of your data.
Every TikTok advertiser hits the same wall. The platform UI tells you what happened. It doesn't tell you what to do next. You end up with a dozen tabs open: campaign manager, creative library, audience insights, a spreadsheet someone built last quarter, trying to synthesize a decision that should take ten minutes.
The BlueAlpha TikTok skills close that gap. Claude connects directly to your TikTok Ads account via MCP (Model Context Protocol), pulls the data, runs the analysis, and returns a structured recommendation inside the conversation. You don't export anything. You don't copy-paste numbers. You type a prompt and get back a decision.
All 9 TikTok skills in the BlueAlpha Marketing Plugin
Account health & optimization
tiktok-auto-optimizetiktok-full-monty
Creative performance
tiktok-creative-fatigue-watchdogtiktok-creative-refresh
Audience & targeting
tiktok-audience-intelligencetiktok-geo-expansiontiktok-incrementality-test
Campaign creation
tiktok-content-to-campaign
Reporting
tiktok-performance-digest
The Analyze → Decide → Plan → Act → Prove Loop for TikTok Ads
Every BlueAlpha skill follows the same five-step pattern:
1. Analyze. Claude calls the TikTok Ads API directly through MCP. No manual exports, no copy-paste. It pulls campaigns, adgroups, creative metrics, audience delivery reports, and interest category taxonomies in real time.
2. Decide. The skill applies BlueAlpha's decision logic: efficiency scores, severity tiers, attribution completeness gauges, spend waste estimates. You get a tier map (Gold/Silver/Bronze/Cut or Critical/High/Moderate/Healthy), not a data dump.
3. Plan. The skill builds a prioritized execution plan with sequencing, dependencies, and risk gates. Budget reallocations get a timeline. Creative refreshes get a brief. Tests get a pre-registered design.
4. Act. Every output ends with a three-bucket action plan: Auto-approve (safe to execute now), Recommend (needs a quick review), Needs discussion (bigger structural moves). You know exactly what to do and in what order.
5. Prove. Post-execution, the skill tracks whether the change produced the expected lift. For incrementality tests, this means statistical significance testing. For budget moves, it means comparing pre/post performance. The proof feeds back into the next Analyze cycle.
Who Should Use the BlueAlpha TikTok Plugin?
Performance marketers running TikTok spend above $10K/month who want a faster weekly optimization cycle
Media buyers managing multiple accounts who need a structured read without manually pulling reports
Growth leads who own the full funnel and need to tie TikTok creative health back to CPA trends
Agency teams who want to show clients a clear, documented optimization rationale, not just a screenshot of the dashboard
BlueAlpha delivers the plugin through forward-deployed engineering. A senior growth partner embeds with your team, builds the measurement and execution stack directly, and trains your team to run the agents independently. You keep the seat. The agents eliminate the hours. The knowledge base stays yours.
How to pick the right skill
If you want to… | Use this skill |
|---|---|
Get a full account health check in one shot |
|
Find out which creatives are dying before CTR drops |
|
Get a brief for net-new creative based on what's working |
|
Understand who's actually converting (age, geo, placement) |
|
Identify new geos to test |
|
Validate that TikTok is driving real incremental revenue |
|
Send leadership a weekly TikTok performance narrative |
|
Turn a blog post or content piece into a TikTok campaign spec |
|
Run everything at once |
|
How Does the BlueAlpha Marketing Plugin Connect to TikTok Ads?
Every skill in the BlueAlpha Marketing Plugin is backed by an MCP connector that gives Claude direct, permissioned access to the TikTok Marketing API. MCP-native means the whole system lives inside Claude, Codex, or any AI workspace your team already uses. No separate login, no dashboard to check. The decision lives where the conversation happens, not in a separate dashboard you check after the fact.
The BlueAlpha TikTok connector gives Claude the ability to:
Pull campaigns, adgroups, ads, and creative-level performance with full breakdown support
Audit account structure and score every campaign on objective alignment, pacing, and creative health
Compute hook rate, hold rate, and completion rate trends across the active creative set
Calculate iOS SKAdNetwork attribution completeness and flag confidence levels on demographic reads
Pull AUDIENCE reports across age, gender, placements, DMAs, provinces, and interest categories
Identify expansion-candidate geos using TikTok's targeting taxonomy
Design geo-split incrementality tests with matched controls and MDE calculation
Where relevant, skills also cross-reference a Meridian MMM (marketing mix model) via the BlueAlpha MMM connector to validate TikTok platform ROAS against causal incrementality data. The MMM is optional. Every skill works without it, but the recommendations get sharper when causal measurement is underneath.
TikTok announced its own official TikTok Ads MCP server at TikTok World in May 2026, which validates the category. That server is positioned as infrastructure for letting external AI agents run campaigns autonomously: setting bids, adjusting budgets, modifying targeting, creating ad assets. The BlueAlpha plugin sits at a different layer. It ships nine TikTok-specific skills that turn API access into decisions: full-account audit with severity tiers, leading-indicator creative fatigue detection, attribution-completeness scoring, audience tier maps with explicit confidence levels, geo expansion analysis, incrementality test design, and content-to-campaign activation. Setup is also different. The BlueAlpha connector handles authentication behind a single sign-in: no developer token, no OAuth configuration, no token refresh management.
How Do I Install the BlueAlpha Marketing Plugin?
There are two pieces to install: the BlueAlpha MCP connector (so Claude can read your TikTok Ads data and your Meridian MMM) and the BlueAlpha Marketing Plugin itself (the nine TikTok skills that put that data to work). Total setup time is about a minute. Steps 1 and 3 are the same regardless of which Claude product you use; Step 2 has two paths depending on whether you're in Cowork or Claude Code.
Step 1: Install the BlueAlpha MCP connector
Open Settings in the Claude desktop app
Go to Connectors → Add custom connector
Name it:
BlueAlpha MCPURL:
https://mcp.bluealpha.ai/mcpClick Connect and sign in with your BlueAlpha account
That single sign-in wires Claude up to your TikTok Ads accounts (and your Meridian MMM, if you have one). No keys, no IDs, no config files.
Step 2: Install the plugin
Pick the path that matches the Claude product you're using.
Option A: Cowork (drag-and-drop)
Click Releases on the right rail and open the latest release
Expand Assets and click
bluealpha-marketing-plugin.pluginto downloadDrag the downloaded file into an open Cowork session and click Install when prompted
That's it. No CLI, no settings menu. One drag.
Option B: Claude Code (slash commands)
Inside Claude Code, run these two commands:
/plugin marketplace add <https://github.com/bluealpha-labs/bluealpha-mcp-plugins.git> /plugin install bluealpha-marketing-plugin
The first registers the GitHub repo as a marketplace; the second installs the plugin from it.
Step 3: Try a skill
Invoking a skill is as simple as typing something like:
"Run tiktok-auto-optimize on my TikTok account, last 14 days, moderate risk tolerance."
Claude will route that to the right skill, load the workflow, and walk you through the Analyze → Decide → Plan → Act → Prove loop.
TikTok Skill Reference: Example Prompts and Outputs
tiktok-auto-optimize
/tiktok-auto-optimize or optimize my TikTok account
Runs a complete optimization cycle across your entire TikTok account. It audits campaign and adgroup structure (naming, objective alignment, budget mode), diagnoses pacing and underspend, identifies budget reallocation opportunities, assesses creative health across the top 10 adgroups, and compiles a risk-tiered action plan. The output separates what you can approve immediately from what needs a conversation.
Real example, FinTech Co (iOS app, $11K daily budget): Auto-Optimize pulled all 5 active campaigns and immediately flagged $981/day in underspend. The root cause was not budget. It was ADGROUP_STATUS_REVIEW_PARTIALLY_APPROVEDon Pangle and Lemon8 placements, a restriction TikTok applies to financial services advertisers in the credit category. Two Checkout campaigns were pacing at 76–77% as a result. The skill scored every campaign (iOS-Creative Test led at 90/100, scale-ready), mapped budget reallocation to the three best-performing adgroups, and delivered 8 action items sorted by risk: 3 auto-approve, 2 recommend, 3 needs discussion. The whole run (live API calls, analysis, output) took under 90 seconds inside Claude.
tiktok-creative-fatigue-watchdog
/tiktok-creative-fatigue-watchdog or check my TikTok creatives for fatigue — last 14 days
Pulls the top 100 creatives by spend for a 14-day recent window and a prior 14-day window, then computes hook rate (video_views_p25 / impressions), hold rate (video_views_p50 / impressions), and completion rate for each. It calculates trend deltas — how much each signal has decayed — and classifies every creative into four severity tiers: Critical, High, Moderate, or Healthy. The output includes a wasted spend estimate, a prioritized refresh queue, and a healthy creative profile that feeds directly into tiktok-creative-refresh.
Hook rate leads CTR by 3–5 days. By the time you see CTR fall in the TikTok dashboard, you've already burned 4–5 days of spend.
Real example, FinTech Co (14 active creatives, $56K 14d spend): The Watchdog found 5 High-severity creatives and 3 Moderate. Creator Clip 142 was the standout: 55.6% hook rate, $41.50 CPA, the account benchmark. Total estimated wasted spend from High-tier decay: ~$2,100/week. Creator Clip 433, the top spender at $7,587 over 14 days, showed hold rate declining -25.3% from the prior window. Early decay in the highest-spend asset, exactly the kind of signal that's invisible in the TikTok UI until it's too late.
tiktok-creative-refresh
/tiktok-creative-refresh or generate a creative refresh brief based on my fatigue watchdog results
Takes the output of the Fatigue Watchdog (or runs it fresh) and turns it into a production-ready creative brief. It extracts the winning attributes from Healthy-tier creatives (hook style, format, video length proxy, CTA patterns) and uses them as the brief foundation. Output includes 3–5 new creative concepts with hook directions, suggested formats (UGC vs. studio), length targets, and music/sound notes, plus a test budget and timeline per concept.
tiktok-audience-intelligence
/tiktok-audience-intelligence or run audience intelligence on my TikTok account — last 30 days
Pulls the TikTok AUDIENCE report across all key dimensions (age × gender, placements, DMAs, provinces, interest categories, and connection type) and builds a tier map for each. Before scoring, it computes the iOS SKAdNetwork attribution completeness: the share of conversions TikTok can attribute to a specific demographic vs. the "NONE/Unknown" bucket. For iOS app-promotion accounts, this often runs below 30%. The skill is explicit about confidence levels: >70% = act on it, 40–70% = directional, <40% = run an incrementality test before making demographic exclusions.
Real example, FinTech Co (iOS app, 30-day window): Attribution completeness came in at 19.6%, meaning 80.4% of conversions landed in the SKAdNetwork unknown bucket. The demographic tier map was flagged as directional only. That said, the signal was clear: Male 18–24 (Gold, $111 CPA) and Male 25–34 (Gold, $115 CPA, 618 device-attributed conversions) were the top performers. Cut-tier segments (Female 55+, Male 55+, Male 45–54, Female 45–54) represented an estimated $14,675/week in wasted spend. The geo read was strong: Chicago ($41.75 CPA), New York ($43.15), and Miami ($45.61) led the DMA tier map. WiFi users converted at $146 CPA vs. $174 for 4G, a 16% gap consistent with at-home, planning-mode financial app sign-ups.
tiktok-geo-expansion
/tiktok-geo-expansion or identify new geographic markets worth testing on TikTok
Analyzes current geo performance across countries, DMAs, and provinces, then cross-references with TikTok's targeting taxonomy to identify expansion candidates. It segments existing geos into Proven (strong CPA, high volume), Exploratory (decent CPA, low volume, worth scaling), Untested (available in TikTok targeting but no current spend), and Poor (cut). Output is a ranked expansion shortlist with suggested test budgets, estimated audience sizes, and a test timeline.
tiktok-incrementality-test
/tiktok-incrementality-test or design a geo-based incrementality test for TikTok — 4-week holdout
Designs a geo-split holdout test to measure true incremental lift from TikTok spend. It selects matched test and control DMAs based on historical conversion similarity, calculates the minimum detectable effect for your budget and timeline, and produces a pre-registered test plan with integrity checks. After the test runs, it reads the results, applies statistical significance testing, and gives you a calibrated CPA you can trust, not the platform-reported number.
tiktok-performance-digest
/tiktok-performance-digest or generate my weekly TikTok performance digest
Produces a weekly (or monthly) performance narrative in the BlueAlpha format: what happened, what drove it, and what to watch. It pulls 7-day and 30-day campaign, creative, and audience trends, identifies the top movers (up and down), flags any anomalies, and writes a 3–4 paragraph executive summary alongside a structured metrics table. Designed to be copy-pasted directly into a Slack update or client report.
tiktok-content-to-campaign
/tiktok-content-to-campaign or promote this blog post as a TikTok campaign — build the full spec
Turns any content piece (a blog post, product launch announcement, organic TikTok video, or news item) into a complete paid campaign spec. Claude reads the content, extracts the core angle and value proposition, and builds a production-ready output: campaign objective, audience tiers (core, broad, retarget), placement settings, creative brief (hook direction, body, close, visual style), KPIs, daily budget, and a pause rule for the test window. The output goes directly to a media buyer or creative team. No reformatting needed.
tiktok-full-monty
/tiktok-full-monty or run the full TikTok analysis on my account
Runs 5 skills in sequence: Auto-Optimize → Creative Fatigue Watchdog → Audience Intelligence → Geo Expansion → Performance Digest. Produces a single unified report with cross-skill callouts. For example, when a fatigued creative clusters in a high-performing demographic, or when a Cut-tier DMA is receiving budget that could flow to an Exploratory geo. Use this for quarterly account reviews or onboarding a new account.
Why BlueAlpha Skills Beat TikTok’s Built-In Optimization
TikTok’s native tools (Smart+ autopilot, automated rules, audience insights) are designed to optimize within the platform's own attribution model and toward TikTok's objective (more spend, more reported conversions). They're useful, but they have three structural limits:
They can't see across channels. TikTok's tools only know about TikTok. BlueAlpha skills can cross-reference your TikTok audience tier map against a Meridian MMM in the same session. When a Gold-tier demographic looks efficient on platform CPA, you can immediately check whether TikTok-as-a-channel is actually driving incremental revenue or just claiming credit.
They don't surface what they can't attribute. The iOS SKAdNetwork attribution gap is real and systematic. For iOS app advertisers, 60–80% of conversions land in anonymous buckets. TikTok's built-in audience insights quietly excludes these and shows you clean-looking demographic data. The Audience Intelligence skill explicitly computes attribution completeness and flags confidence levels so you know whether the demographic read you're acting on represents 20% or 80% of your actual conversion volume.
They optimize for metrics, not decisions. Auto-Optimize found $981/day in underspend. The root cause was not a budget issue. It was a platform restriction (ADGROUP_STATUS_REVIEW_PARTIALLY_APPROVED) on Pangle placements for financial services advertisers. TikTok's automated rules would have suggested increasing budgets. The BlueAlpha skill identified the actual constraint and recommended a targeted fix: redirect the stranded budget to the iOS-CT Alpha adgroup, which had a $30.18 CPA and room to scale.
How BlueAlpha Runs Your TikTok Budget Like a Portfolio
BlueAlpha runs your TikTok budget like a portfolio position: measured causally, rebalanced toward what works, and executed across platforms. Causal measurement sits underneath every recommendation. MCP-native agents produce deployment-ready specs. A forward-deployed growth partner makes sure the system gets sharper every week.
The result: your team runs TikTok the way a portfolio manager runs capital. Every dollar is proven, every decision is auditable, and the agents eliminate the analytical hours that used to eat your week. The same connector powers BlueAlpha's Google Ads, Meta Ads, and LinkedIn Ads skill families. For a side-by-side comparison of all MCP servers for performance marketing, see 11 MCP Servers Reviewed. To see the full platform, book a walkthrough.
FAQ
Will the skills make changes to my TikTok account automatically?
No. All skills are read-only by default. The action plan output tells you what to do, but nothing is executed until you explicitly confirm. Write actions (pausing ads, adjusting budgets) are in the roadmap for a future plugin version.
How does the iOS SKAdNetwork attribution gap affect the analysis?
For iOS app-promotion campaigns, TikTok uses SKAdNetwork to report conversions on Apple devices. These conversions arrive without device-level signal (no age, no gender, no DMA), so they land in "Unknown" buckets. The Audience Intelligence skill measures what percentage of your conversions are device-attributed vs. unknown. Below 40% completeness, the demographic tier map is unreliable for making exclusion decisions. The skill will flag this and recommend a geo-split incrementality test instead.
Can I run the skills on multiple TikTok accounts?
Yes. The MCP connector surfaces all advertiser accounts associated with your Business Center login. When you run a skill, Claude will list available advertisers and ask you to confirm which one to analyze.
How often should I run each skill?
Auto-Optimize: weekly, or before any significant budget change. Creative Fatigue Watchdog: weekly for accounts spending >$50K/month on TikTok, bi-weekly for $10K–$50K, monthly below that. Audience Intelligence: monthly, or after any major campaign structure change. Performance Digest: weekly. Full Monty: quarterly.
What can the BlueAlpha plugin do that TikTok's official MCP can't?
TikTok's official MCP server (announced at TikTok World in May 2026) opens TikTok Ads Manager to external AI agents for autonomous campaign management (setting bids, adjusting budgets, modifying targeting, creating ad assets). That server is infrastructure for letting an agent run a campaign. The BlueAlpha plugin sits at a different layer. It ships nine TikTok-specific skills that turn API access into decisions: full-account audit with severity tiers, leading-indicator creative fatigue detection, iOS SKAdNetwork attribution-completeness scoring, audience tier maps with explicit confidence levels, geo expansion analysis, incrementality test design with statistical significance testing, and content-to-campaign activation. The BlueAlpha connector also handles authentication behind a single sign-in: no developer token, no OAuth configuration, no token refresh management.
Your Next Step: Run Your First TikTok Audit
If you have the BlueAlpha Marketing Plugin installed, run:
If you don't have the plugin yet, install it from the Cowork plugin marketplace and connect your TikTok Ads account in Settings, Connectors. The first Auto-Optimize run on a live account typically surfaces 3–5 actionable items within 2 minutes.
Questions? Book a demo or find us on the Cowork plugin marketplace.
