TikTok Ads connector for Claude

Use Porter’s TikTok Ads connector for Claude to see which video hooks, ad groups and audiences pay off, then pause ads, change budgets and build campaigns you approve.

  • Rank video ads by hook rate and drop-off
  • Catch tired ads early and pause them
  • Pace campaign budgets and change them mid-month
  • Compare TikTok Ads with Meta Ads in one table
G2★★★★★Rated 4.6/5 from 288 G2 reviews (October 2026)

By Porter Metrics team · Last updated October 19, 2026

ClaudePorter connected
Show Spend, Impressions, Clicks and Conversion by Campaign Name for the last 7 full days, with CTR, CPM and CPA.
Porter / TikTok Ads / Trailgear Demo✓ 4 rows
Spark Ads – Creators converts cheapest at $11 CPA. Catalog – Broad has the highest CPM at $9.80.
Campaign NameSpendConversionCPA
Spark Ads – Creators$88080$11
UGC – Trail Shoes$1,12064$17.50
Catalog – Broad$97038$25.50
Awareness – TopView$6009$66.70
Demo data, Trailgear Demo account
628 TikTok Ads fields
01Setup

How to connect TikTok Ads to Claude

Porter’s TikTok Ads connector for Claude takes 3 steps, with no code and no TikTok developer app. Connect your ad accounts in Porter with TikTok sign-in, add one MCP URL to Claude as a custom connector, then sign in and ask. Claude Code, as well as the free Sheets and BigQuery routes, are in the TikTok Ads to Claude tutorial with screenshots. MCP (Model Context Protocol) is the open standard Claude uses to connect to tools such as Porter.

Before you start

  • You need a free Porter account, any Claude plan and a TikTok login. That login also needs a role on the ad account in TikTok Ads Manager or Business Center. Custom connectors work in Claude, Cowork and Claude Desktop on Free, Pro, Max, Team and Enterprise plans. Free allows one custom connector, while on Team an Owner adds it first (Anthropic’s guide to custom connectors in Claude).
  • Works in Claude.ai, Claude Desktop, Cowork and Claude Code, with any Claude model, from Opus to Sonnet and Haiku.
  1. Step 1: Connect TikTok Ads in Porter

    Sign up free at Porter, pick TikTok Ads as the source and then sign in with TikTok. Tick every ad account Claude should read (accounts you don’t tick show as needing reconnection), then pick Claude as the destination.

  2. Step 2: Add the TikTok Ads connector to Claude

    Then, in Claude, open Connectors → Manage connectors → “+” → Add custom connector, name it Porter Metrics, paste this URL and click Add:

    MCP URL
    https://mcp.portermetrics.com/mcp
  3. Step 3: Ask Claude about TikTok Ads

    Finally, sign in with your Porter account, approve access and paste this first prompt:

    Prompt
    List my TikTok ad accounts and show Spend, Impressions, Clicks and Conversion by Campaign Name for the last 7 full days. Calculate CTR, CPM and CPA yourself.

Guides and videos

Start free and connect TikTok Ads

app.portermetrics.com / create
Porter's Select accounts window for TikTok Ads with a demo account and the Connect button
First, in Porter, open TikTok Ads and select Connect.
TikTok screen listing the permissions Porter requests for your ad account
Then, approve the permissions Porter asks for in TikTok.
Claude's Add custom connector window with the name Porter Metrics and Porter's MCP URL filled in
Then, in Claude, add a custom connector with Porter's MCP URL.
Porter's Application Access Request screen asking you to let Claude use the Porter MCP server
When Claude asks, sign in to Porter and select Allow Access.
Porter Metrics listed as a connected connector in Claude with its read-only tools
After that, Porter shows as connected, so you can ask your first question.
If you prefer video, watch the whole TikTok Ads to Claude setup (1:38, no sound).
Interactive walkthrough, so you can click along here
02Use cases and prompts

What you can ask Claude

Each use case comes with a prompt to copy, the fields it uses from the TikTok Ads fields Claude can read and who it’s for. The prompts work out CTR, CPM, CPA and hook rate from raw counts, so totals stay right across campaigns.

Can Claude show which TikTok video ads hook viewers in the first seconds?

The problemViewers swipe away before your product ever shows up, and you can’t tell which opening is losing them.

What Claude doesClaude ranks ads by 2-second and 6-second views, as well as by how many viewers reach 25, 50, 75 and 100% of each video. Then it shows where each ad loses people. Spark Ads come through with their numbers too, so find them by Ad Name.

What you getYou know which openings to reuse in the next batch of videos, instead of judging creatives by total views.

Prompt
For the last 14 days, by Campaign Name and Ad Name, show Spend, Impressions, Video Play Actions, Video Watched 2S, Video Watched 6S, Video Views P25, Video Views P50, Video Views P75, Video Views P100 and Average Video Play. Calculate hook rate (Video Watched 2S ÷ Impressions) and the drop-off from P25 to P75. Rank the 15 ads with the most Spend by hook rate.

For: creative strategists · UGC and performance agencies · in-house media buyers

Fields used: Campaign NameAd NameSpendImpressionsVideo Play ActionsVideo Watched 2SVideo Watched 6SVideo Views P25/P50/P75/P100 (tiktok_ads_video_views_p25, _p50, _p75, _p100)Average Video Play

Can Claude rank TikTok campaigns and ad groups by CPA and ROAS?

The problemSpend spreads across more ad groups every week, but you can’t see at a glance which ones still hit your CPA.

What Claude doesClaude pulls Spend, results and purchase value by campaign and ad group, then works out CPA, CTR and CPM. It also flags every ad group whose CPA runs 20% over the account’s.

What you getBudget moves to the ad groups that hit your CPA, from one ranked table instead of an Ads Manager export.

Prompt
For the last 30 days, by Campaign Name, Campaign objective type and Adgroup Name, show Spend, Impressions, Clicks, Conversion, Complete Payment and Complete Payment Roas. Calculate CTR, CPM and CPA (Spend ÷ Conversion) for each ad group and for the account as a whole, then list ad groups with CPA more than 20% above the account's.

For: in-house media buyers · e-commerce marketers · agencies (add Advertiser name for one row per client)

Fields used: Campaign NameCampaign objective typeAdgroup NameSpendImpressionsClicksConversionComplete PaymentComplete Payment Roas

Can Claude spot TikTok ads that are wearing out and pause them?

The problemOn TikTok a winning video burns out fast: CPM creeps up, CTR slides, and by the time you notice, the week’s budget is gone.

What Claude doesClaude pulls weekly Impressions, Clicks, Spend and 6-second views per ad, then works out CTR, CPM and 6-second view rate. It also flags ads that slipped two weeks in a row, then pauses the ones you pick.

What you getFresh videos go live before the tired ones eat another week of budget.

Prompt
For the last 6 weeks, by Week, Campaign Name and Ad Name, show Impressions, Clicks, Spend and Video Watched 6S. Calculate weekly CTR, CPM and 6-second view rate (Video Watched 6S ÷ Impressions), and flag ads where CTR fell and CPM rose two weeks in a row.
Then ask
Prompt
Pause the flagged ads after I confirm, and list each one first.

For: in-house media buyers · agencies

Fields used: WeekCampaign NameAd NameImpressionsClicksSpendVideo Watched 6S
Action: ad_status_update (DISABLE)

Can Claude tell you which ages, genders and placements your TikTok ads convert with?

The problemYour videos were made for a Gen Z audience, but you’re not sure who is actually buying.

What Claude doesClaude breaks Spend, Impressions, Clicks and Conversion down by age, gender, placement or platform, then flags segments that spend without converting. Conversions without an age or gender sit in their own “NONE” row, so read account totals from campaign-level numbers.

What you getYou can narrow targeting, or brief creative for the audience that actually converts, from one set of tables.

Prompt
For the last 30 days, show Age, Spend, Impressions, Clicks and Conversion. Calculate CPA per age group and list age groups with more than $300 Spend and CPA at least 30% above the account's.
Then ask
Prompt
Run the same breakdown by Gender, then by Placement, then by Platform, as separate tables.

For: in-house media buyers · agencies · e-commerce marketers

Fields used: AgeGenderPlacementPlatformSpendImpressionsClicksConversion

Can Claude pace TikTok campaign budgets and change them?

The problemSince it took off over the weekend, a campaign is now on track to burn through the month’s budget early.

What Claude doesClaude reads each campaign’s budget and daily Spend, then projects month-end spend from the last 7 days. After that, it sets a campaign or ad group budget to the amount you choose, as long as it clears TikTok’s daily minimums.

What you getYou fix pacing mid-month, while a budget change can still land the campaign on target.

Prompt
This month, by Date and Campaign Name, show Spend, Campaign Budget and Campaign Budget Mode. Using the last 7 days' average Spend, which campaigns will finish the month more than 10% over or 20% under budget, and by how much?
Then ask
Prompt
Lower the daily budget of the campaign most likely to overspend so it lands on budget. Show me the new amount before you change it.

For: agencies · in-house media buyers

Fields used: DateCampaign NameSpendCampaign BudgetCampaign Budget Mode
Actions: campaign_update · adgroup_update (budget) · adgroup_list (ad group budgets)

Can Claude report TikTok Shop GMV Max results by product?

The problemGMV Max decides where the Shop budget goes, so you’re left guessing which products actually pay for themselves.

What Claude doesClaude reads GMV Max cost, gross revenue, orders and ROI by GMV Max campaign and product, then ranks products by ROI.

What you getYou see which products earn their GMV Max spend, so the next Shop promotion features the ones that pay back.

Prompt
For the last 30 days, show GMV Max Campaign Name, GMV Max Product Name, GMV Max Cost, GMV Max Gross Revenue, GMV Max Orders and GMV Max ROI. Don't add other TikTok Ads metrics. Rank products by GMV Max ROI and flag those with GMV Max Cost above $200 and ROI under 2.

For: e-commerce marketers · e-commerce managers · TikTok Shop agencies

Fields used: GMV Max Campaign NameGMV Max Product NameGMV Max CostGMV Max Gross RevenueGMV Max OrdersGMV Max ROI

Can Claude build a TikTok campaign from a brief?

The problemNew UGC videos arrive every week, and each one means another round of uploads, covers and ad groups.

What Claude doesClaude uploads your video from a link, then picks a cover. After that, it builds the campaign, an ad group with budget, schedule, placements, age, gender and locations, and the ad.

What you getEach new UGC video becomes a ready campaign for you to check, instead of an afternoon in Ads Manager.

Prompt
Create a paused Website Conversions campaign 'Fall Drop – Prospecting' with one ad group: $60 daily budget starting {date}, United States, ages 18–34, TikTok placement, optimizing for Complete Payment with my pixel. Upload the video at {URL}, pick a cover, and create one ad with my authorized TikTok account, CTA 'Shop now' and landing page {URL}. Show me everything before you create it.

For: agencies · in-house media buyers

Actions: video_upload · video_suggest_cover · campaign_create · adgroup_create · identity_list · pixel_list · ad_create · read-back campaign_get, adgroup_get

Can Claude compare with Meta Ads in one table?

The problemYour client wants to know if TikTok should take budget from Meta, but the two platforms count results differently.

What Claude doesWith both ad platforms in Porter, Claude puts spend, impressions, conversion value and ROAS side by side by platform and campaign. Each platform attributes conversions its own way, so compare ROAS rather than totals.

What you getYou split budget between TikTok and Meta from one ROAS comparison, while the campaigns worth scaling are already named.

Prompt
Compare my TikTok Ads and Meta Ads accounts for the last 30 days: ad spend, impressions, conversion value and ROAS by platform and campaign name. Which platform returns more per dollar, and which three campaigns should get more budget?

For: marketing leads · e-commerce marketers · agencies

Fields used: Porter blend fields amount_spentads_impressionsblended_conversion_value_platformblended_roas_platformcampaign_nameper-platform fallback SpendComplete Payment RoasCampaign Name
03Why Porter

Why Porter for TikTok Ads in Claude

Porter puts TikTok Ads next to your other ad platforms, GA4 and Shopify under the same field names, on any Claude plan. If TikTok is your only channel and you need catalog, Smart+ or GMV Max changes, TikTok’s own TikTok for Business MCP Server covers more of TikTok (TikTok’s guide to its TikTok for Business MCP Server). You can run both.

✓

628 ready-made fields

Claude reads 628 named fields, from 2-second views and video quartiles to TikTok Shop and GMV Max results. The prompts follow TikTok’s report rules, so they skip the field mixes TikTok rejects.

⊞

Changes only after you approve

The chat that finds a tired ad also uploads the new video, pauses the old one and moves budget. New campaigns and ad groups start paused, and Claude asks before every write.

⚙

Years of daily data, not 30 days

TikTok’s API returns at most 30 days of daily rows per request. Porter has returned daily data back to October 2021, so Claude compares this season with past years.

Aa

TikTok Ads next to Meta Ads and Shopify

Ask about TikTok next to Meta Ads, Google Ads, GA4, Shopify and the rest of Porter’s 20+ data sources in one chat, under the same field names.

↻

Any Claude plan, a sign-in that lasts

Porter works on every Claude plan, and your TikTok access lasts until you revoke it. TikTok’s own server needs Pro or Max (TikTok’s guide to connecting Claude) and a new authorization every 30 days.

✓

One URL, nothing to host

Sign in with TikTok and paste one URL in Claude, with no developer app or server to run as AdsMCP’s open-source TikTok Ads MCP server needs. The same accounts also feed ChatGPT, Data Studio and BigQuery.

⊞

Live dashboards, not only chat answers

Ask Claude for a dashboard and Porter’s AI dashboards publish it at its own link, synced automatically and ready to share. Official MCP servers answer inside the chat and stop there.

04Dashboard

Dashboard template

Porter’s hosted TikTok Ads dashboard gives Claude a starting layout. It shows Spend, video views, 2-second views, likes, follows, CPM and cost per 1,000 reached, by campaign and over time. Then ask Claude to rebuild or extend it from your own account, or browse Porter’s free TikTok Ads dashboard templates.

AI dashboards

Build a live TikTok Ads dashboard from the chat

Describe the dashboard in one sentence and Porter builds it. A client-ready dashboard in minutes, with no chart dragging and no BI tool to learn. Ask Claude:

Prompt
Build a live TikTok Ads dashboard for my account with the last 30 days, the main KPIs and a weekly trend.
Live URLEach dashboard at its own link: no login, no app, no download
Auto-syncFresh TikTok Ads data, nobody re-exports each period
Scheduled deliveryEmail or PDF sends on a set day
White labelYour logo and branding for clients
Sharing permissionsView or edit access per person
TikTok Ads AI dashboard template built with Porter Metrics AI dashboards
Template

The TikTok Ads AI dashboard template

Built with Porter's AI dashboards on a real account. Open it live, then ask Claude to make one like it for your account.

Open the live TikTok Ads dashboard

05Pricing

Pricing

You can start free, since Porter’s TikTok Ads connector for Claude comes with every plan. Use the calculator for your number of accounts, or see Porter pricing for every plan.

What you get

  • Free plan: never expires, with unlimited connected accounts and the last 15 days of data in Claude (30 days in Data Studio and Sheets)
  • Reporting: from $12.50 per account a month billed annually, or $15 month to month for one account
  • Billing: each TikTok ad account counts as one account, with volume discounts and no per-seat fee
  • Changes: 1 AI credit per completed change, about 5 to launch one ad from scratch; failed tasks are free, and the Free plan includes 100 credits a month
  • Trial: 14 days of full access, no card

Price calculator

$33.33/mo$6.67 per account

An account is one ad account, Stripe account, store, page or GA4 property. The Free plan never expires and has unlimited accounts, with the last 15 days of data in AI chats.

06Data and actions

TikTok Ads data and actions in Claude

The TikTok Ads connector gives Claude 628 fields and 40 actions to read, create, change and delete. The fields cover campaigns, ad groups and ads, including delivery, conversions, video, engagement, TikTok Shop, GMV Max, SKAN and audience breakdowns. You'll also find each one named in the TikTok Ads fields list.

The 12 TikTok Ads fields Claude uses most

FieldWhat it's for
Date / Weektiktok_ads_stat_time_day · tiktok_ads_weekDaily and weekly trends
Advertiser nametiktok_ads_advertiser_nameOne row per ad account
Campaign Name / Adgroup Name / Ad Nametiktok_ads_campaign_name · tiktok_ads_adgroup_name · tiktok_ads_ad_nameRows at each level
Campaign objective typetiktok_ads_campaign_objective_typeGroup campaigns by goal
Spend (with Cash Spend)tiktok_ads_spend · tiktok_ads_cash_spendSpend with vouchers; Cash Spend for cash only
Impressionstiktok_ads_impressionsBase for CPM and hook rate
Clickstiktok_ads_clicksBase for CTR and CPC
Conversiontiktok_ads_conversionBase for CPA
Complete Payment Roastiktok_ads_complete_payment_roasReturn on spend from purchases
ROAS (Onsite)tiktok_ads_onsite_shopping_roasReturn on spend from TikTok Shop
Video Watched 2S / 6S and Video Views P25–P100tiktok_ads_video_watched_2s · tiktok_ads_video_watched_6s · tiktok_ads_video_views_p25…Hook, hold and drop-off by quartile
Age (with Gender, Placement, Platform)tiktok_ads_age · tiktok_ads_gender · tiktok_ads_placement · tiktok_ads_platformAudience breakdowns

Can Claude create, pause or change TikTok Ads campaigns?

Yes. Claude creates campaigns, ad groups and ads through Porter, including single video, image, carousel or a Spark post under your identity. It also enables, pauses or deletes them and changes names, budgets, bids, schedules and targeting.

Beyond campaigns, Claude also uploads videos and images and builds customer-file and lookalike audiences. It also exports instant-form leads and hides, shows, deletes or replies to ad comments. Instant forms, identities, catalog ads and GMV Max changes stay in TikTok Ads Manager, where you handle them as usual.

How fresh is the data, and how far back?

Most metrics reach Claude about 30 minutes after they happen, according to TikTok's data latency for reports. Reach, cash spend and audience breakdowns take about 16 hours, while TikTok corrects real-time numbers daily at 12:00 UTC. So far, Porter has returned daily data back to October 2021.

Product stats

WhatTikTok Ads connector
Fields628 across campaigns, ad groups and ads: delivery, conversions, video, engagement, TikTok Shop, GMV Max, SKAN and audience breakdowns
Actions40 to read, create, change and delete, after you approve; new campaigns and ad groups start paused
FreshnessMost metrics in about 30 minutes; reach, cash spend and audience breakdowns in about 16 hours; TikTok corrects real-time numbers daily at 12:00 UTC
HistoryDaily data back to October 2021 so far, past TikTok's 30-day limit per request; the last 15 days in Claude on the Free plan (30 days in Data Studio and Sheets)
Speed and rate limitsAd-level questions take 1–2 minutes; 1,000 rows per page within TikTok's API limits for Porter's app (TikTok Marketing API rate limits)
Report rulesGMV Max fields and audience breakdowns run as their own questions, one breakdown at a time
AccessTikTok sign-in on the ad accounts you tick; changes need an Admin or Operator role; access lasts until you revoke it

See all 628 TikTok Ads fields

07Security

Is it safe?

Yes, with approvals: the TikTok Ads connector for Claude shows every change before Porter sends it. Also, nothing spends until you enable it. Deletes are permanent, so pause rather than delete. Porter signs in with TikTok's OAuth, then works only with the role you already have on each ad account.

How you approve changes

Porter creates new campaigns and ad groups paused, and Claude asks before every write. Then enable them top-down: campaign, then ad group, then ad. Budgets go in whole currency units and must also clear TikTok's daily minimums.

Deleting a campaign, ad group, ad, audience, comment or comment reply is permanent, so pause instead when you might want it back. Each completed change also uses one AI credit.

What the connector needs from TikTok Ads

When you sign in, use a TikTok user who has a role on the ad account in TikTok Ads Manager or Business Center. Then tick each ad account on TikTok's consent screen. TikTok's ad account permissions let Admins and Operators create and edit ads, while Analysts view them.

Creating ads also needs an authorized TikTok identity (a TikTok account) or a Spark post, rather than a custom identity. TikTok's access lasts until you or the account admin revoke it, per TikTok's long-term access token docs.

08FAQ

FAQ

These answers cover other AI tools, agency accounts, organic and Shop data, instant-form leads, ad comments and audiences. The last three help when numbers don't match, a question fails or a change doesn't go through.

Does the TikTok Ads connector work in ChatGPT and Claude Code?

Yes, the MCP URL behind the TikTok Ads connector for Claude also works in ChatGPT and Claude Code. If you want to connect TikTok Ads to ChatGPT, follow Porter's ChatGPT tutorial. Porter's Claude tutorial covers Claude Code, including TikTok Shop and GMV Max questions.

Can I connect several TikTok ad accounts, say as an agency?

Yes, one TikTok login brings every ad account that user can reach into Porter. Then Claude can compare them in one answer with Advertiser name as a column. Porter bills each ad account once it's connected, so an agency pays only for the client accounts it adds.

Does the TikTok Ads connector include organic posts or TikTok Shop seller data?

TikTok Shop ad results, such as GMV Max and Purchases (Onsite), are part of the ads data Claude reads. Organic profile and video data comes through Porter's separate TikTok Insights (organic) connector for Claude, which works in Claude the same way.

Can Claude download leads from TikTok instant forms?

Yes. Claude lists your instant forms, starts a lead export for a date range, then returns each lead's name, email, phone and custom answers. You build new instant forms in TikTok's Instant Page editor as usual, then Claude exports their leads for you.

Can Claude hide or reply to comments on my TikTok ads?

Yes, Claude lists the comments on your ads by date, hides or shows them, and also replies as the advertiser with your wording. Use it to clear spam from a top-spending ad or answer product questions instead of opening TikTok Ads Manager.

Can Claude build custom and lookalike audiences on TikTok?

Yes. Paste or upload customer emails or phone numbers, and Porter hashes them before Claude builds a customer-file audience. Claude can also add or remove people, or build a lookalike for the regions you choose. To delete an audience, first take it off any active ad group, since TikTok keeps audiences in use.

Troubleshooting

Why don't Claude's numbers match TikTok Ads Manager?

Check four things before you compare Claude's answer with TikTok Ads Manager. Dates follow the ad account's time zone, per TikTok's reporting docs on ad account time zones, and recent days change until TikTok's daily fix. Spend includes vouchers while Cash Spend doesn't. Porter also returns CTR as a fraction (0.0088 means 0.88%).

Why did a TikTok Ads question fail or take a minute?

Ask GMV Max fields on their own and use one audience breakdown per question, since TikTok reports them separately. Porter keeps those report types apart, so a question that mixes GMV Max with Spend, or two audience breakdowns, fails. Ad-level questions take 1–2 minutes, so Claude collects the result when it's ready.

Why can't Claude create or change my TikTok ad?

Reconnect TikTok Ads in Porter and tick that ad account. Then check that your TikTok user has a role on it, since Claude makes the changes your TikTok login allows. Other causes are a missing authorized TikTok identity, a budget under TikTok's minimum, or a task you do in TikTok Ads Manager as usual, such as instant forms or catalog ads.

09Next

More Claude connectors

Porter brings more than TikTok Ads into Claude, and also sends TikTok Ads to more than Claude. Browse all Claude connectors to pick another source, or send your data to Data Studio (formerly Looker Studio) for dashboards or to BigQuery for SQL.

Not only Claude. Send TikTok Ads data anywhere

The same Porter account and connection also send TikTok Ads data to these destinations, at no extra cost.

Try the connector in Claude

Sign up free and set up the TikTok Ads connector for Claude in 3 steps, then ask your first question. For example, ask which videos hook viewers, which ad groups miss your CPA target or which budget will overspend. Then make the change in the same chat.

Free forever plan · 14-day full trial · No card

Media buyers: CPA, ROAS and pacing per ad group, as well as the budget change, in one chat.

Creative strategists: hook rate and drop-off for every video that spends, ready before the next brief.

Agencies: one prompt covers every client ad account, so the weekly report starts there.