tiktok-ads-mcp

# TikTok Ads MCP A comprehensive Model Context Protocol (MCP) server for interacting with the TikTok Business API. This package provides a complete interface to access TikTok advertising campaigns, ad groups, ads, and generate detailed performance reports. ## Features - **Read-Only TikTok Business API Integration**: Access all major TikTok advertising endpoints for data retrieval - **6 Comprehensive Tools**: Business centers, ad accounts, campaigns, ad groups, ads, and reports - **Advanced Filtering**: Powerful filtering options for all data retrieval operations - **Multi-Advertiser Support**: Handle multiple advertiser accounts in a single request - **Flexible Reporting**: Generate detailed performance reports with custom dimensions and metrics - **Real-time Data**: Access live advertising data and performance metrics - **Error Handling**: Comprehensive error handling and validation - **Modular Architecture**: Clean, maintainable code structure - **Safe Operations**: All tools are read-only and will not modify your campaigns or ad data ## Available Tools 1. **get_business_centers** - Retrieve business centers accessible by your access token 2. **get_authorized_ad_accounts** - Get all authorized advertiser accounts 3. **get_campaigns** - Retrieve campaigns with comprehensive filtering options 4. **get_ad_groups** - Get ad groups with advanced filtering and targeting options 5. **get_ads** - Retrieve ads with detailed creative and performance data 6. **get_reports** - Generate comprehensive performance reports and analytics ## Prerequisites - Python 3.8 or higher - TikTok Business API access - Valid API credentials (app ID, secret, access token) ## Quick Start ### Installation ```bash # Install the latest version from PyPI pip install tiktok-ads-mcp ``` ### Configuration 1. **Set up environment variables** in your MCP client configuration: ```json { "mcpServers": { "tiktok-ads": { "command": "python", "args": ["-m", "tiktok_ads_mcp"], …