tiktok-ads

This MCP server provides a TikTok Ads integration for managing campaigns, ad groups, and performance analytics via the Model Context Protocol. It supports authentication flows for TikTok Ads, retrieving campaigns and ad groups, and obtaining performance metrics. You can authenticate, select an advertiser account, fetch campaigns, and pull detailed performance data for reporting and optimization. The server exposes tools such as tiktok_ads_login, tiktok_ads_get_campaigns, tiktok_ads_get_campaign_details, tiktok_ads_get_adgroups, tiktok_ads_get_campaign_performance, and tiktok_ads_get_adgroup_performance to power conversational automation workflows and reporting dashboards. To use it, configure the MCP client with the tiktok-ads server entry and provide the necessary environment credentials for TikTok Ads API access. The integration is designed to support multi-account management, OAuth flows, and rate-limited, retry-enabled API calls.

Prerequisites:

• Python 3.10+
• Git
• Access to TikTok For Business API (developer account, app registration, and API credentials)

Local Installation:

# Clone the repository (replace with your actual repo URL)
git clone <repository-url>
cd adsmcp-server

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

# Install dependencies in editable mode
pip install -e .

Using uv (recommended):

# Install uv if not already installed
pip install uv

# Run the MCP server (example command)
uv sync

If you prefer running the server directly with Python (alternative):

# Activate venv if not already active
source venv/bin/activate

# Run the server script directly (adjust path as needed)
python /path/to/adsmcp-server/run_server.py

Remote MCP Server Option: If you prefer using AdsMCP remote server, you can connect your TikTok Ads accounts via AdsMCP Remote MCP Server Setup Guide. This eliminates local configuration and dependencies while enabling quick onboarding.

Tips and notes:

• Keep API credentials secure; use environment variables and avoid committing them to version control.
• Ensure OAuth tokens are rotated and stored securely; implement token refresh logic where applicable.
• The server includes rate limiting and retry logic to handle TikTok API rate limits; consider configuring backoff strategies in your client.
• Verify that you have the correct Advertiser ID and permissions for the actions you intend to perform (campaign management, creative uploads, etc.).
• When testing, start with a sandbox or limited accounts to avoid unintended ad spend or changes.
• If you encounter authentication failures, re-run the OAuth flow and double-check App ID/Secret scopes and redirect URIs.
• For production deployments, consider using HTTPS, proper secret management, and monitoring of API usage and errors.