TikTok Ads · MCP

TikTok Ads MCP Server: ask Claude about your data

The Detrics MCP server gives Claude read-only access to your TikTok Ads account. You ask in plain language and Claude answers from your live data, not a stale export.

Try it now Read Documentation

Available on the free plan: 35 queries/month, no credit card.

Ask your agent about TikTok Ads

Build a weekly TikTok Ads report for my client meeting

Detect anomalies in my TikTok Ads spend over the past 14 days

Which TikTok Ads campaigns should I pause this quarter?

What was my TikTok Ads spend last month vs. the month before?

What you can analyze in TikTok Ads

Video Performance Funnel

Track video plays, 2-second views, 6-second views, and complete views. Monitor average play time and cost per 6-second view for optimization.

Creative Testing Analytics

Analyze creative material performance with thumbnail engagement. Track creative fatigue and refresh recommendations.

Audience Engagement Metrics

Monitor secondary goal results, clicks, and conversions. Track engagement patterns by audience segment and interest.

Campaign Objective Tracking

Analyze performance by campaign objective. Optimize for objective-specific KPIs and conversion events.

In-Feed Performance

Track placement-specific metrics for In-Feed ads. Monitor engagement rates and cost efficiency by placement.

Conversion Attribution

Analyze app install attribution and web conversions with view-through and click-through windows.

What Claude can see in TikTok Ads

711 metrics and 80 dimensions, including:

campaign nameadgroup namespendimpressionsclicks

Need full history and SQL? See the TikTok Ads BigQuery connector

HOW IT WORKS

How the TikTok Ads MCP server works

Connect TikTok Ads once and query it in plain language.

First step

Connect your first datasource

Link any of 32+ marketing and ecommerce platforms in a couple of clicks.

Connect a source

Second step

Connect Detrics to Claude

Add Detrics as an MCP connector in Claude. Your marketing data is ready to query in plain language.

Connect to Claude

And that's it

Start talking to your data

Ask Claude for any report in plain language. It builds the dashboard from your real numbers, no hallucinations.

Try it in Claude

Build a buyer-journey dashboard from my marketing data

Buyer journey LIVE

Sessions 12,302

Checkouts 145

Purchases 55

Close rate 37.9%

Done · generated by Detrics

Technical setup for developers

Add Detrics to any MCP-compatible client using your API key from app.detrics.io/mcp:

{
  "mcpServers": {
    "detrics": {
      "command": "npx",
      "args": ["-y", "detrics"],
      "env": {
        "DETRICS_API_KEY": "dk_••••••••"
      }
    }
  }
}

Available tools include list_connections, list_accounts, list_fields, and query_marketing_data. All TikTok Ads access is read-only.

MCP

Frequently Asked Questions

How does Claude access my TikTok Ads data?

You connect TikTok Ads to Detrics once. The Detrics MCP server then exposes read-only query tools that Claude can call. Claude never sees your credentials and can never modify your TikTok Ads account.

What kind of TikTok Ads breakdowns can Claude run?

Anything the TikTok Ads API exposes through Detrics, including campaign performance, conversions & e-commerce, creative & audience. That covers 711 metrics and 80 dimensions, over any date range your account allows.

Which AI clients are supported?

Any MCP-compatible client: Claude Desktop, Claude.ai, Claude Code, Cursor, Windsurf, and more.

How much does it cost?

MCP access is available on every Detrics plan. On the free plan it uses your 35 monthly data refreshes (the same quota as Google Sheets), no credit card required. Paid plans unlock higher quotas.

Ask your first TikTok Ads question today

Get Started Free

*No credit card required

Works with Claude, Cursor, Windsurf & more
Read-only access, OAuth 2.0 secured
Free plan with 35 queries/month