Model Context Protocol server for integration with TikTok Ads API that enables AI assistants to interact with TikTok advertising campaigns, providing comprehensive capabilities for campaign management, analytics, and optimization.

Installation

From Source Code

# Clone the repository
git clone <repository-url>
cd adsmcp-server

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -e .

Using uv (Recommended)

# Install with uv
uv sync

Configuration

Claude Desktop

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

Available Tools

Tool	Description
tiktok_ads_login	Initiate TikTok Ads OAuth authentication process
tiktok_ads_complete_auth	Complete OAuth authentication with authorization code
tiktok_ads_auth_status	Check current authentication status
tiktok_ads_switch_ad_account	Switch to a different ad account
tiktok_ads_get_campaigns	Retrieve all campaigns for an ad account
tiktok_ads_get_campaign_details	Get detailed information about a specific campaign
tiktok_ads_get_adgroups	Retrieve ad groups for a campaign
tiktok_ads_get_campaign_performance	Get performance metrics for campaigns with support for detailed metrics
tiktok_ads_get_adgroup_performance	Get performance metrics for ad groups with breakdown

Features

• Campaign Management: Create, read, and update campaigns and ad groups
• Performance Analytics: Retrieve detailed performance metrics and insights
• Audience Management: Work with custom audiences and targeting parameters
• Creative Management: Upload and manage advertising creatives
• Reporting: Generate and download custom performance reports

Environment Variables

Required

• TIKTOK_APP_ID - Your TikTok Ads API Application ID
• TIKTOK_APP_SECRET - Your TikTok Ads API Application Secret

Notes

This project is part of the AdsMCP AI advertising automation platform. A remote MCP server option is available at AdsMCP.com for quick setup without manual configuration. Requires a TikTok For Business account with API access and a TikTok Ads developer account. The server includes built-in rate limiting and retry logic. API limits: 1000 requests per hour per application, 10 concurrent requests.