Tiktok Ads Mcp Server

What is Tiktok Ads Mcp Server?

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

How to use Tiktok Ads Mcp Server?

Install Python 3.10+, clone the repository, set up a virtual environment, and install dependencies via pip install -e . or uv sync. Configure environment variables (TIKTOK_APP_ID, TIKTOK_APP_SECRET, TIKTOK_ACCESS_TOKEN, TIKTOK_ADVERTISER_ID) and add the server to your MCP client’s configuration (e.g., Claude Desktop) with the command and environment variables.

Key features of Tiktok Ads Mcp Server

• Campaign management (create, read, update campaigns and ad groups)
• Performance analytics with detailed metrics and insights
• Audience management and custom targeting options
• Creative management (upload and manage ad creatives)
• Reporting and custom performance report generation

Use cases of Tiktok Ads Mcp Server

• Manage TikTok ad campaigns via an AI assistant
• Retrieve and analyze campaign performance metrics
• Upload and organize ad creative assets
• Generate custom performance reports for optimization
• Switch between multiple advertiser accounts

FAQ from Tiktok Ads Mcp Server

What are the prerequisites to use this server?

You need Python 3.10+, a TikTok For Business account with API access, and a TikTok Ads Developer account with a registered app.

How do I authenticate with the TikTok Ads API?

Set the environment variables TIKTOK_APP_ID, TIKTOK_APP_SECRET, TIKTOK_ACCESS_TOKEN, and TIKTOK_ADVERTISER_ID. For development, use long-lived tokens; for production, implement the full OAuth 2.0 flow with automatic token refresh.

What are the API rate limits?

The TikTok Ads API allows 1000 requests per hour per app, with a maximum of 10 concurrent requests. The server includes built-in rate limiting and retry logic.

How do I configure this server in an MCP client like Claude Desktop?

Add an entry to the mcpServers configuration with the command python, the path to run_server.py, and the four required environment variables.

How does error handling work?

The server handles API rate limits, token expiration, network connectivity issues, and invalid parameters. It provides comprehensive error messages and automatic retry logic.