TikTok Ads

You run a TikTok Ads MCP Server to interface with TikTok’s advertising APIs, enabling AI assistants to manage campaigns, pull analytics, and optimize ads across your accounts with centralized control and automation.

How to use

You connect your MCP client to the TikTok Ads MCP Server to perform actions such as authenticating with TikTok, listing campaigns, viewing performance, and managing audiences and creatives. Start by configuring your client to point at the local or remote MCP server, then use the provided tools to authenticate, fetch campaigns, retrieve performance data, and generate reports. Use the authentication tools to sign in, switch advertiser accounts as needed, and verify your connection status before attempting any data retrieval or updates.

Typical workflows you can perform include: authenticating with TikTok, selecting the advertiser account you want to manage, listing campaigns and ad groups, checking campaign or ad group performance, uploading or managing creatives, and generating performance reports for your campaigns. You can run these actions through the MCP client by invoking the corresponding tools exposed by the server. Always ensure tokens are fresh and that you respect rate limits.

How to install

Prerequisites include Python 3.10 or newer and a TikTok For Business account with API access. You also need a TikTok Ads Developer account with app registration and the necessary API credentials.

Local installation steps you can follow on your machine are shown below. Run these commands in your terminal to set up the server locally.

# 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 .

# Optional: install UV for running the server if you prefer the UV runner
uv sync

# Alternative: run the server locally using the stdio configuration (see MCP Client Configuration below)

Additional sections

Remote MCP Server option is available if you prefer not to host the server yourself. A remote MCP server lets you connect your ad accounts quickly without setting up server dependencies. You can follow a dedicated remote setup guide to connect your accounts.

MCP client configuration example for connecting from your client (such as Claude Desktop) is provided in the setup. This config points to the local or remote server and passes the necessary TikTok API credentials.

Authentication details outline how to register as a developer, obtain API credentials, perform the OAuth flow, and securely manage tokens. You will need the App ID, App Secret, and Advertiser ID to operate the MCP server against TikTok Ads APIs.

Security best practices include never storing credentials in code, using environment variables for sensitive data, rotating tokens, monitoring API usage and rate limits, and ensuring all communications use HTTPS.

The server enforces API rate limits and includes retry logic to handle congestion. Typical limits include a high-per-hour request ceiling, a cap on concurrent requests, and endpoint-specific constraints. Implement error handling for rate limits, token expiration, network issues, and invalid parameters.

You can expect ongoing maintenance through a changelog that documents new features, such as campaign management, performance reporting, and OAuth support, in addition to improvements and bug fixes.

If you encounter issues or questions, you can open an issue to seek help or clarification.

License details indicate the project is released under the MIT License, with full terms available in the LICENSE file.

The following toolset is available for interacting with the TikTok Ads MCP Server. You can authenticate, fetch campaigns, and retrieve performance data using the MCP client.

Available tools

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

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

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

tiktok_ads_upload_creative

Upload and manage ad creatives

tiktok_ads_generate_report

Generate and download custom performance reports