TikTok Ads MCP Server

A Model Context Protocol (MCP) server for TikTok Ads API integration. This server enables AI assistants like Claude to interact with TikTok advertising campaigns, providing comprehensive campaign management, analytics, and optimization capabilities.

Part of the AdsMCP project - MCP servers for advertising platforms.

Features

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

Installation

Prerequisites

Python 3.10+
TikTok For Business account with API access
TikTok Ads Developer account and app registration

Local Installation

# 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

MCP Client Configuration

Add to your MCP client configuration (e.g., 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

Authentication

tiktok_ads_login - Start TikTok Ads OAuth authentication flow
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 advertiser account

Campaign Management

tiktok_ads_get_campaigns - Retrieve all campaigns for the advertiser account
tiktok_ads_get_campaign_details - Get detailed information about a specific campaign
tiktok_ads_get_adgroups - Retrieve ad groups for a campaign

Performance & Analytics

tiktok_ads_get_campaign_performance - Get performance metrics for campaigns with detailed metrics support
tiktok_ads_get_adgroup_performance - Get performance metrics for ad groups with breakdowns

Authentication

TikTok Ads API Setup

Register as Developer
- Visit TikTok For Business Developer Portal
- Create a developer account
- Register your application
Get API Credentials
- App ID and App Secret from your registered app
- Generate access token through OAuth flow
- Note your Advertiser ID
OAuth Flow (for production)
- Implement OAuth 2.0 flow for user authorization
- Handle token refresh automatically
- Store tokens securely

Security Best Practices

Never commit API credentials to version control
Use environment variables for sensitive data
Implement proper token rotation
Monitor API usage and rate limits
Use HTTPS for all communications

API Rate Limits

TikTok Ads API has the following limits:

1000 requests per hour per app
10 concurrent requests
Specific endpoint limits may apply

The server includes built-in rate limiting and retry logic.

Error Handling

The server provides comprehensive error handling:

API rate limit management
Token expiration handling
Network connectivity issues
Invalid parameter validation

License

This project is licensed under the MIT License - see the LICENSE file for details.

TikTok Ads MCP Server