TikTok Ads MCP Server

Community MCP server that connects AI assistants to TikTok Ads via the TikTok Business Marketing API for campaign management and performance reporting.

Advertising by AdsMCP (community) OAuth2 active

GitHub Docs

Overview

The TikTok Ads MCP server by the AdsMCP team is a Python-based Model Context Protocol server that lets AI assistants like Claude interact with the TikTok Business Marketing API. It exposes tools for OAuth login, multi-advertiser account switching, campaign and ad group retrieval, and pulling performance metrics so an agent can answer reporting questions and inspect account structure using natural language.

The server handles OAuth 2.0 against the TikTok For Business developer portal, supports switching between advertiser accounts, and includes built-in rate limiting (1000 requests per hour per app, 10 concurrent requests) with retry logic to stay within TikTok's API quotas. It is intended for self-hosting alongside a local MCP client.

Note: TikTok announced an official first-party Ads MCP server at TikTok World on May 13, 2026, but no public endpoint, GitHub repo, or developer documentation has been released yet. Until then, this AdsMCP community implementation is one of the more complete options, alongside ysntony/tiktok-ads-mcp.

Tools

Tool	Description
`tiktok_ads_login`	Initiates the TikTok Ads OAuth login flow and returns an authorization URL.
`tiktok_ads_complete_auth`	Completes the OAuth flow by exchanging the authorization code for an access token.
`tiktok_ads_auth_status`	Returns the current authentication status and active advertiser context.
`tiktok_ads_switch_ad_account`	Switches the active TikTok advertiser account used by subsequent calls.
`tiktok_ads_get_campaigns`	Lists campaigns for the active advertiser account.
`tiktok_ads_get_campaign_details`	Retrieves detailed configuration and status for a specific campaign.
`tiktok_ads_get_adgroups`	Fetches ad groups belonging to a campaign or advertiser.
`tiktok_ads_get_campaign_performance`	Returns campaign-level performance metrics (impressions, clicks, spend, CTR, conversions) for a date range.
`tiktok_ads_get_adgroup_performance`	Returns ad group performance metrics with optional breakdowns.

Setup Guide

Prerequisites

Python 3.10 or higher
A TikTok For Business account with API access
A registered app in the TikTok Ads Developer Portal (provides TIKTOK_APP_ID and TIKTOK_APP_SECRET)

Install

git clone https://github.com/AdsMCP/tiktok-ads-mcp-server.git
cd tiktok-ads-mcp-server
python -m venv venv
source venv/bin/activate   # Windows: venv\Scripts\activate
pip install -e .

Or with uv:

uv sync

Claude Desktop / MCP client config

{
  "mcpServers": {
    "tiktok-ads": {
      "command": "python",
      "args": ["/path/to/tiktok-ads-mcp-server/run_server.py"],
      "cwd": "/path/to/tiktok-ads-mcp-server",
      "env": {
        "TIKTOK_APP_ID": "your_app_id",
        "TIKTOK_APP_SECRET": "your_app_secret"
      }
    }
  }
}

First run

After starting the server, call tiktok_ads_login to receive an OAuth URL, authorize the app in your TikTok For Business account, then call tiktok_ads_complete_auth with the returned code. Use tiktok_ads_switch_ad_account to choose which advertiser the subsequent calls should target.

Use Cases

Pull weekly TikTok campaign performance (spend, CTR, conversions) into an AI assistant for reporting without opening Ads Manager.
Compare ad group level metrics across multiple advertiser accounts in a single conversation using account switching.
Diagnose underperforming campaigns by asking the agent to drill from campaign totals into ad group breakdowns.
Generate stakeholder summaries of TikTok ad performance over a chosen date range.
Audit campaign and ad group configuration (status, objectives, budgets) across an entire advertiser.

Example Prompts

"Log in to TikTok Ads, then show me all active campaigns on advertiser 7123456789."
"Pull spend, impressions, clicks, CTR, and conversions for every campaign in the last 14 days."
"Switch to advertiser 7129999999 and list its ad groups with their daily budgets."
"Give me the top 5 ad groups by ROAS for campaign 1810000000 over the last 30 days."
"Compare last week vs this week campaign performance and tell me which campaigns dropped."

Pros

Covers the core read workflow advertisers need: auth, account switching, campaigns, ad groups, and performance metrics.
Implements proper OAuth 2.0 with the TikTok For Business developer portal and supports multiple advertiser accounts.
Built-in rate limiting and retry logic respect TikTok's 1000 requests per hour per app quota.
MIT licensed and self-hostable.

Limitations

Community-maintained, not an official TikTok product. The official TikTok Ads MCP server announced at TikTok World 2026 is not yet publicly available.
The documented tool set is read-oriented: there are no first-class tools for creating campaigns, editing budgets, uploading creatives, or managing audiences, despite those being described as goals.
Requires manual Python setup, a TikTok developer app, and OAuth completion before any agent calls work.

Alternatives

ysntony/tiktok-ads-mcp: another community MCP server for the TikTok Business API focused on campaigns, ad groups, ads, and reporting.
markifact/markifact-mcp: multi-platform ads MCP covering Google Ads, Meta Ads, GA4, TikTok Ads, and LinkedIn Ads with human-in-the-loop writes.
TikTok's forthcoming official Ads MCP server, announced at TikTok World 2026, once it ships public docs and an endpoint.