TikTok Ads MCP by InsightfulPipe
Hosted TikTok Ads MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
What can you do with TikTok Ads MCP by InsightfulPipe?
- In-Feed Ads - Native video ads in the For You feed
- Spark Ads - Boosted organic content
- Collection Ads - Product catalog ads
- Lead Generation - In-app lead forms
- App Install Campaigns - Mobile app promotion
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
Remote (streamable-http)
Claude Code
claude mcp add --transport http tiktok-ads-mcp-by-insightfulpipe 'https://tiktok-ads.insightfulmcp.com/'JSON configuration (Claude Desktop, Cursor, VS Code)
{
"mcpServers": {
"tiktok-ads-mcp-by-insightfulpipe": {
"type": "http",
"url": "https://tiktok-ads.insightfulmcp.com/"
}
}
}Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
- TikTok Ads MCP Server by Insightful Pipe
- MCP Server URL
- What is TikTok Ads MCP?
- Installation
- Available Actions
- Control What Your AI Can Do
- Usage Examples
- Supported TikTok Ad Features
- Supported Metrics
- Why TikTok Ads MCP?
- Security
- Pricing
- Ready-Made Skills and Prompts
- Explore More MCP Servers by Insightful Pipe
- Resources
- Support
- License
TikTok Ads MCP Server by Insightful Pipe
Connect TikTok Ads to AI assistants for automated analytics and campaign optimization.
Part of the Insightful Pipe MCP Server Collection — The TikTok Ads MCP server brings TikTok advertising data to Claude, ChatGPT, Cursor, and other AI assistants. Analyze campaign performance, optimize ad spend, and get AI-powered insights for your TikTok marketing.
MCP Server URL
https://tiktok-ads.insightfulmcp.com/What is TikTok Ads MCP?
TikTok Ads MCP is a remote Model Context Protocol server that enables AI assistants to access and analyze your TikTok For Business advertising data. With this MCP integration you can:
- Query TikTok ad performance using natural language
- Analyze video ad engagement and conversion metrics
- Get AI recommendations for creative optimization
- Monitor CPM, CPC, and ROAS across campaigns
- Access detailed campaign, ad group, and ad metadata
Installation
Claude
- Copy the MCP Server URL:
https://tiktok-ads.insightfulmcp.com/ - Open Claude Connectors Settings
- Scroll to the bottom and click Add custom connector
- Paste the URL and click Add
- Click Connect and sign in to InsightfulPipe if asked. Claude then lists the connector as connected.
ChatGPT
Custom MCP servers are added through ChatGPT's Developer mode. Availability depends on your ChatGPT plan, and workspace admins may need to allow it.
- Turn on Developer mode in ChatGPT settings
- Create a new app for a remote MCP server and paste the URL:
https://tiktok-ads.insightfulmcp.com/ - Sign in to InsightfulPipe if asked. The connection finishes as soon as you are signed in.
See OpenAI's guide: Developer mode and MCP apps in ChatGPT
Claude Code
claude mcp add --transport http tiktok-ads https://tiktok-ads.insightfulmcp.com/Cursor
Add the server to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):
{
"mcpServers": {
"tiktok-ads": {
"url": "https://tiktok-ads.insightfulmcp.com/"
}
}
}When Cursor shows Needs authentication, click Connect and sign in to InsightfulPipe if asked.
Available Actions
89 actions: 15 read, 74 write.
Read Actions (15)
| Action | Description |
|---|---|
adgroups_metadata | Returns ad group configuration including targeting, bidding, and schedule settings |
ads_metadata | Returns full ad entity metadata for the specified advertiser |
advertisers_metadata | Returns the connected advertiser's account details |
campaign_gmv_max_info | Returns the full configuration of one GMV Max campaign, including its store_id |
campaign_gmv_max_session_get | Returns the details of up to 20 max delivery or creative boost sessions |
campaign_gmv_max_session_list | Lists the max delivery and creative boost sessions inside a Product GMV Max campaign |
campaigns_metadata | Returns campaign level settings including objective, budget, and schedule |
gmv_max_campaigns | Lists GMV Max campaigns |
gmv_max_report | GMV Max campaign performance (cost, orders, gross revenue, ROI, product/video/LIVE breakdowns) |
gmv_max_store_list | Lists the TikTok Shops linked to the advertiser |
integrated_report_basic | Primary BASIC reporting endpoint |
tool_bid_recommend | Get bid recommendations for an ad group based on targeting and objective |
tool_targeting_category_recommend | Get recommended targeting categories based on advertiser vertical |
tool_targeting_info | Get detailed targeting info (location names, ISP info, etc.) |
tool_targeting_search | Search for targeting options by keyword (geo locations, zip codes, etc.) |
Write Actions (74)
Show all 74 write actions
| Action | Description |
|---|---|
ad_create | Create a new ad (created in DISABLE status for safety) |
ad_image_upload | Upload an image for use in ad creatives |
ad_status_update | Enable, disable, or delete ads in batch |
ad_update | Update an existing ad's creative or settings |
ad_video_upload | Upload a video for use in ad creatives |
adgroup_create | Create a new ad group (created in DISABLE status for safety) |
adgroup_status_update | Enable, disable, or delete ad groups in batch |
adgroup_update | Update an existing ad group's settings |
advertiser_update | Update advertiser account settings (company name, address, etc.) |
app_create | Register a mobile app for ad tracking and optimization |
app_update | Update a registered mobile app's settings |
blockedword_create | Create blocked words for comment filtering |
blockedword_delete | Delete blocked words |
blockedword_task_create | Create a bulk blocked word management task |
blockedword_update | Update blocked words for comment filtering |
campaign_create | Create a new campaign (created in DISABLE status for safety) |
campaign_gmv_max_create | Create a GMV Max campaign for TikTok Shop (created in DISABLE status for safety) |
campaign_gmv_max_session_create | Create a GMV Max session campaign (created in DISABLE status for safety) |
campaign_gmv_max_session_delete | Delete a GMV Max session campaign |
campaign_gmv_max_session_update | Update a GMV Max session campaign |
campaign_gmv_max_update | Update a GMV Max campaign |
campaign_status_update | Enable, disable, or delete campaigns in batch |
campaign_update | Update an existing campaign's settings (name, budget, etc.) |
comment_delete | Delete comments on ads |
comment_post | Post a reply to a comment on an ad |
comment_status_update | Hide or unhide comments on ads |
comment_task_create | Create a bulk comment management task |
creative_asset_delete | Delete creative assets (images/videos) |
creative_asset_share | Share creative assets with other advertisers |
creative_image_edit | Edit a creative image (crop, resize, etc.) |
creative_portfolio_create | Create a creative portfolio (instant page, etc.) |
creative_shareable_link_create | Create a shareable link for creative preview |
creative_smart_text_generate | Generate smart text suggestions for ad creatives |
custom_audience_apply | Apply a custom audience to ad groups |
custom_audience_create | Create a custom audience from customer file or engagement data |
custom_audience_delete | Delete custom audiences |
custom_audience_file_upload | Upload a customer file for custom audience creation |
custom_audience_lookalike_create | Create a lookalike audience based on an existing custom audience |
custom_audience_lookalike_update | Update a lookalike audience |
custom_audience_rule_create | Create a rule-based custom audience |
custom_audience_share | Share a custom audience with other advertisers |
custom_audience_share_cancel | Cancel sharing of a custom audience |
custom_audience_update | Update an existing custom audience |
gmv_max_exclusive_authorization_create | Create exclusive authorization for GMV Max campaigns |
identity_create | Create a legacy Custom Identity (CUSTOMIZED_USER) where TikTok still allows it |
offline_create | Create an offline event set for offline conversion tracking |
offline_delete | Delete an offline event set |
offline_update | Update an offline event set |
optimizer_rule_batch_bind | Bind automated rules to entities in batch |
optimizer_rule_create | Create an automated optimization rule |
optimizer_rule_update | Update an automated optimization rule |
pangle_block_list_update | Update the Pangle block list for the advertiser |
pixel_create | Create a TikTok pixel for conversion tracking |
pixel_event_create | Create a pixel event for tracking specific conversions |
pixel_event_delete | Delete pixel events |
pixel_event_update | Update a pixel event |
pixel_update | Update a TikTok pixel's settings |
playable_delete | Delete a playable ad creative |
playable_save | Save a playable ad creative after upload |
playable_upload | Upload a playable ad creative |
saved_audience_create | Create a saved audience with predefined targeting |
saved_audience_delete | Delete saved audiences |
smart_plus_ad_appeal | Appeal a rejected Smart+ ad |
smart_plus_ad_create | Create a Smart+ ad (created in DISABLE status for safety) |
smart_plus_ad_material_status_update | Update material status for Smart+ ads |
smart_plus_ad_status_update | Enable, disable, or delete Smart+ ads in batch |
smart_plus_ad_update | Update a Smart+ ad |
smart_plus_adgroup_create | Create a Smart+ ad group (created in DISABLE status for safety) |
smart_plus_adgroup_status_update | Enable, disable, or delete Smart+ ad groups in batch |
smart_plus_adgroup_update | Update a Smart+ ad group |
smart_plus_campaign_create | Create a Smart+ automated campaign (created in DISABLE status for safety) |
smart_plus_campaign_status_update | Enable, disable, or delete Smart+ campaigns in batch |
smart_plus_campaign_update | Update a Smart+ campaign's settings |
term_confirm | Confirm TikTok terms of service |
Control What Your AI Can Do
You decide what AI agents can do with each connected account:
- Turn individual actions on or off for every connected account, so agents only see the actions you allow.
- Connect as Read-only or Read & Write. A read-only connection can only enable read actions.
- Destructive actions stay off by default. Actions such as deletes are disabled until an admin enables them.
- Team access per account. Restricted team members only use the accounts they are granted, with the read actions enabled on them.
Usage Examples
Campaign Performance
"How are my TikTok ad campaigns performing this week?"Video Creative Analysis
"Which video ads have the highest completion rate?"Audience Insights
"What demographics are converting best on my TikTok ads?"Ad Group Analysis
"Show me the targeting settings for my top performing ad groups"Optimization Recommendations
"Which TikTok ad groups should I increase budget for?"Supported TikTok Ad Features
- In-Feed Ads - Native video ads in the For You feed
- Spark Ads - Boosted organic content
- Collection Ads - Product catalog ads
- Lead Generation - In-app lead forms
- App Install Campaigns - Mobile app promotion
Supported Metrics
| Metric | Description |
|---|---|
| Video Views | Total video ad views |
| View Rate | Percentage of impressions that resulted in views |
| 6s View Rate | Users who watched 6+ seconds |
| Completion Rate | Users who watched the full video |
| CTR | Click-through rate |
| CPC | Cost per click |
| CPM | Cost per 1,000 impressions |
| Conversions | TikTok Pixel conversions |
| ROAS | Return on ad spend |
Why TikTok Ads MCP?
For TikTok Marketers
- Real-time insights - Query live campaign data
- Creative optimization - Understand what resonates
- Trend identification - Stay ahead on TikTok
For Gen-Z Focused Brands
- Audience understanding - Deep demographic insights
- Engagement analysis - Beyond clicks and impressions
- Content strategy - Data-driven creative decisions
For Performance Marketers
- Budget optimization - AI-powered recommendations
- Cross-platform comparison - Compare TikTok vs other channels
Security
- Official TikTok API for Business - Direct integration with TikTok's API
- OAuth 2.0 - Secure authentication
- Data encryption - Secure transmission
Pricing
The TikTok Ads MCP server is included in every InsightfulPipe plan, together with all other MCP servers and the CLI. Plans start at $29.99/month, and you can try it for 7 days. See insightfulpipe.com/pricing for current plans.
Ready-Made Skills and Prompts
- Claude skills for TikTok Ads — ready-made skills that run on your connected data
- Tiktok Ads Campaign Performance Report
- Tiktok Ads Creative Performance Analysis
- Tiktok Ad Group Targeting Analysis
Explore More MCP Servers by Insightful Pipe
Visit insightfulpipe.com/mcp-servers to discover our full collection of MCP servers for marketing and analytics.
Advertising MCP Servers
- Facebook Ads MCP - Meta advertising
- Google Ads MCP - Google advertising
- LinkedIn Ads MCP - B2B advertising
- Snapchat Ads MCP - Snapchat advertising
- Pinterest Ads MCP - Pinterest advertising
Video & Social MCP Servers
- YouTube MCP - YouTube analytics
- Instagram MCP - Instagram analytics
Resources
Support
- Documentation: insightfulpipe.com/docs
- All MCP Servers: insightfulpipe.com/mcp-servers
- Email: support@insightfulpipe.com
Insightful Pipe — AI-powered marketing analytics through MCP servers. Explore all integrations →
License
MIT License - see LICENSE for details.
Frequently asked questions
What is TikTok Ads MCP by InsightfulPipe?
Hosted TikTok Ads MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
How do I install TikTok Ads MCP by InsightfulPipe?
It runs as a remote server. In Claude Code: claude mcp add --transport http tiktok-ads-mcp-by-insightfulpipe 'https://tiktok-ads.insightfulmcp.com/'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does TikTok Ads MCP by InsightfulPipe need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is TikTok Ads MCP by InsightfulPipe open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains TikTok Ads MCP by InsightfulPipe?
It is published by Insightful-Pipe. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.