TikTok Ads MCP Server

1# TikTok Ads MCP Server
2 
3A 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.
4 
5This project is part of the [AdsMCP AI advertising automation platform](https://adsmcp.com), 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. 
6 
7 
8## Features
9 
10- **Campaign Management**: Create, read, and update campaigns and ad groups
11- **Performance Analytics**: Retrieve detailed performance metrics and insights
12- **Audience Management**: Handle custom audiences and targeting options
13- **Creative Management**: Upload and manage ad creatives
14- **Reporting**: Generate and download custom performance reports
15 
16## Installation
17 
18### Prerequisites
19 
20- Python 3.10+
21- TikTok For Business account with API access
22- TikTok Ads Developer account and app registration
23 
24### Local Installation
25 
26```bash
27# Clone the repository
28git clone <repository-url>
29cd adsmcp-server
30 
31# Create virtual environment
32python -m venv venv
33source venv/bin/activate  # On Windows: venv\Scripts\activate
34 
35# Install dependencies
36pip install -e .
37```
38 
39### Using uv (recommended)
40 
41```bash
42# Install with uv
43uv sync
44```
45 
46## Remote MCP Server Option
47 
48If you don’t want to host the server and set it up manually yourself, [AdsMCP](https://adsmcp.com) 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](https://adsmcp.com/onboarding)** for a step-by-step tutorial to quickly connect your ad accounts.
49  
50 
51### MCP Client Configuration
52 
53Add to your MCP client configuration (e.g., Claude Desktop):
54 
55```json
56{
57  "mcpServers": {
58    "tiktok-ads": {
59      "command": "python",
60      "args": ["/path/to/adsmcp-server/run_server.py"],
61      "cwd": "/path/to/adsmcp-server",
62      "env": {
63        "TIKTOK_APP_ID": "your_app_id",
64        "TIKTOK_APP_SECRET": "your_app_secret",
65      }
66    }
67  }
68}
69```
70 
71## Available Tools
72 
73### Authentication
74- `tiktok_ads_login` - Start TikTok Ads OAuth authentication flow
75- `tiktok_ads_complete_auth` - Complete OAuth authentication with authorization code
76- `tiktok_ads_auth_status` - Check current authentication status
77- `tiktok_ads_switch_ad_account` - Switch to a different advertiser account
78 
79### Campaign Management
80- `tiktok_ads_get_campaigns` - Retrieve all campaigns for the advertiser account
81- `tiktok_ads_get_campaign_details` - Get detailed information about a specific campaign
82- `tiktok_ads_get_adgroups` - Retrieve ad groups for a campaign
83 
84### Performance & Analytics
85- `tiktok_ads_get_campaign_performance` - Get performance metrics for campaigns with detailed metrics support
86- `tiktok_ads_get_adgroup_performance` - Get performance metrics for ad groups with breakdowns
87 
88## Authentication
89 
90### TikTok Ads API Setup
91 
921. **Register as Developer**
93   - Visit [TikTok For Business Developer Portal](https://business-api.tiktok.com/)
94   - Create a developer account
95   - Register your application
96 
972. **Get API Credentials**
98   - App ID and App Secret from your registered app
99   - Generate access token through OAuth flow
100   - Note your Advertiser ID
101 
1023. **OAuth Flow** (for production)
103   - Implement OAuth 2.0 flow for user authorization
104   - Handle token refresh automatically
105   - Store tokens securely
106 
107## Security Best Practices
108 
109- Never commit API credentials to version control
110- Use environment variables for sensitive data
111- Implement proper token rotation
112- Monitor API usage and rate limits
113- Use HTTPS for all communications
114 
115## API Rate Limits
116 
117TikTok Ads API has the following limits:
118- 1000 requests per hour per app
119- 10 concurrent requests
120- Specific endpoint limits may apply
121 
122The server includes built-in rate limiting and retry logic.
123 
124## Error Handling
125 
126The server provides comprehensive error handling:
127- API rate limit management
128- Token expiration handling
129- Network connectivity issues
130- Invalid parameter validation
131 
132## License
133 
134This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
135 
136## Support
137 
138For issues and questions, please create an issue in this repository.
139 
140## Changelog
141 
142### v0.1.0 (Initial Release)
143- Basic TikTok Ads API integration
144- Campaign and ad group management
145- Performance reporting
146- OAuth authentication support