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

MCP Free Verified stdio 146 lines By AdsMCP Awesome List - punkpeye/awesome-mcp-servers

Description

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.

What This MCP Enables

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

```bash

Stack & Dependencies

- Python 3.10+ - TikTok For Business account with API access - TikTok Ads Developer account and app registration

Use Cases

*Campaign Management**: Create, read, and update campaigns and ad groups

Using - Python 3.10+ and - TikTok For Business account with API access

*Performance Analytics**: Retrieve detailed performance metrics and insights

Using - Python 3.10+ and - TikTok For Business account with API access

*Audience Management**: Handle custom audiences and targeting options

Using - Python 3.10+ and - TikTok For Business account with API access

*Creative Management**: Upload and manage ad creatives

Using - Python 3.10+ and - TikTok For Business account with API access

*Reporting**: Generate and download custom performance reports

Using - Python 3.10+ and - TikTok For Business account with API access

Frequently Asked Questions

What technologies does TikTok Ads MCP Server require?

This MCP server requires - Python 3.10+, - TikTok For Business account with API access, and - TikTok Ads Developer account and app registration. Ensure these are available in your environment before configuring it with Claude Code.

How does TikTok Ads MCP Server communicate with Claude?

TikTok Ads MCP Server uses the stdio transport protocol to communicate with Claude Code via the Model Context Protocol.

Is TikTok Ads MCP Server free to use?

TikTok Ads MCP Server is completely free to use. You can download the configuration or copy it directly from the page.

What capabilities does TikTok Ads MCP Server provide?

This MCP server enables Claude to: **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; and 2 more capabilities.

Download Config GitHub

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

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

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

```bash
# Clone the repository
git clone 
cd adsmcp-server

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venvScriptsactivate

# Install dependencies
pip install -e .
```

### Using uv (recommended)

```bash
# Install with uv
uv sync
```

## Remote MCP Server Option

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

### MCP Client Configuration

Add to your MCP client configuration (e.g., Claude Desktop):

```json
{
  "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**
   - Visit [TikTok For Business Developer Portal](https://business-api.tiktok.com/)
   - Create a developer account
   - Register your application

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

► Necessary Cookies Standard

Necessary cookies enable essential site features like secure log-ins and consent preference adjustments. They do not store personal data.

None

► Functional Cookies Remark

Functional cookies support features like content sharing on social media, collecting feedback, and enabling third-party tools.

None

► Analytical Cookies Remark

Analytical cookies track visitor interactions, providing insights on metrics like visitor count, bounce rate, and traffic sources.

None

► Advertisement Cookies Remark

Advertisement cookies deliver personalized ads based on your previous visits and analyze the effectiveness of ad campaigns.

None