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.
This project is part of the AdsMCP AI advertising automation platform, an AI-powered platform designed to simplify and automate ad campaign management across multiple advertising networks. The platform emphasizes efficiency, data-driven insights, and intelligent automation for marketers and agencies. Additionally, AdsMCP also supports integration with other advertising platforms, such as Google Ads and Meta (Facebook) Ads, making it easier to manage campaigns across multiple networks from a single interface.
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
Remote MCP Server Option
If you don’t want to host the server and set it up manually yourself, AdsMCP provides a remote MCP server. You can easily connect your ad accounts within one minute, without worrying about server configuration or dependencies. Visit the AdsMCP Remote MCP Server Setup Guide for a step-by-step tutorial to quickly connect your ad accounts.
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 flowtiktok_ads_complete_auth- Complete OAuth authentication with authorization codetiktok_ads_auth_status- Check current authentication statustiktok_ads_switch_ad_account- Switch to a different advertiser account
Campaign Management
tiktok_ads_get_campaigns- Retrieve all campaigns for the advertiser accounttiktok_ads_get_campaign_details- Get detailed information about a specific campaigntiktok_ads_get_adgroups- Retrieve ad groups for a campaign
Performance & Analytics
tiktok_ads_get_campaign_performance- Get performance metrics for campaigns with detailed metrics supporttiktok_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.
Support
For issues and questions, please create an issue in this repository.
Changelog
v0.1.0 (Initial Release)
- Basic TikTok Ads API integration
- Campaign and ad group management
- Performance reporting
- OAuth authentication support