Skip to main content
Glama

TikTok Ads MCP Server

by AdsMCP
GitHub
Python
MIT License
3
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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.

Part of the AdsMCP project - MCP servers for advertising platforms.

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

Configuration

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

Campaign Management

  • 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

Performance & Analytics

  • 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

Authentication

TikTok Ads API Setup

  1. Register as Developer

  2. Get API Credentials

    • App ID and App Secret from your registered app

    • Generate access token through OAuth flow

    • Note your Advertiser ID

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

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables AI assistants to manage TikTok advertising campaigns through the TikTok Ads API. Supports campaign creation, performance analytics, audience management, creative operations, and custom reporting through natural language interactions.

  1. Features
    1. Installation
      1. Prerequisites
      2. Local Installation
      3. Using uv (recommended)
    2. Configuration
      1. MCP Client Configuration
    3. Available Tools
      1. Authentication
      2. Campaign Management
      3. Performance & Analytics
    4. Authentication
      1. TikTok Ads API Setup
    5. Security Best Practices
      1. API Rate Limits
        1. Error Handling
          1. License
            1. Support
              1. Changelog
                1. v0.1.0 (Initial Release)

              New MCP Servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/AdsMCP/tiktok-ads-mcp-server'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server