TikTok Ads MCP. Manage campaigns and report metrics via conversation.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
TikTok Ads connects your AI agent directly to TikTok's advertising platform. Manage campaigns, check ad performance metrics, and adjust budgets without ever opening the TikTok Ads Manager dashboard.
Your agent can list campaigns, pull ROAS data across date ranges, pause underperforming ads, and even query audience interests—all conversationally.
It’s direct command line control for your ad spend.
What your AI agents can do
Enable campaign
Turns on a campaign that has been paused or disabled in the TikTok Ads system.
Get ad reporting
Retrieves performance metrics for individual ads, showing data like clicks and impressions.
Get adgroup reporting
Pulls detailed performance reports specifically for an entire ad group.
Retrieves historical data like spend, clicks, and ROAS for entire campaigns over a specific time period.
Provides full lists of every active ad or ad group in your TikTok account for quick review.
Stops a campaign immediately if its performance metrics fall below a set threshold.
Pulls granular performance data for individual ad groups, helping pinpoint which segments need attention.
Activates a campaign that was previously paused or disabled through the system.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
TikTok Ads MCP Server: 8 Tools for Ad Management
Manage your entire advertising lifecycle—from listing assets to running complex performance comparisons—using these eight tools.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using TikTok Ads on Vinkius019d7612enable campaign
Turns on a campaign that has been paused or disabled in the TikTok Ads system.
019d7612get ad reporting
Retrieves performance metrics for individual ads, showing data like clicks and impressions.
019d7612get adgroup reporting
Pulls detailed performance reports specifically for an entire ad group.
019d7612get campaign reporting
Generates comprehensive financial and engagement data for a whole campaign.
019d7612list adgroups
Retrieves a complete list of every ad group currently active in your account.
019d7612list ads
Lists all the individual ads (creative assets) associated with your campaigns.
019d7612list campaigns
Gets a full overview and list of every campaign running on your account.
019d7612pause campaign
Disables an entire ad campaign immediately when poor performance is detected.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with TikTok Ads, then connect any of our 4,800+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,800+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by TikTok Ads. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 8 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Checking ad performance used to require opening 5 different dashboards.
Today, checking one campaign's full picture is a nightmare. You have to open the main manager dashboard, click 'Campaigns,' then drill down into specific ads groups, and finally run separate reports for metrics like CPC vs ROAS. It’s copy-paste hell—you end up with half an hour just gathering data.
With this MCP server, you skip all that clicking. You ask your agent to compare performance (get_campaign_reporting) from last month versus this month. The results come back instantly in plain English, giving you the key metrics right away.
Using TikTok Ads with the MCP Server: full control.
The most common manual task is identifying underperformers. You manually review every ad group's spend, cross-referencing it against its conversion rate to decide if it needs a budget cut or an outright pause. This process is slow and highly prone to human error.
Now, you simply tell your agent: 'Pause all ads with ROAS under 2x.' The server executes the logic by running `get_adgroup_reporting` across all groups, identifying the weak links, and then calling `pause_campaign`—all in one go. It’s simple. You trust it.
What you can do with this MCP connector
Yo, forget logging into the TikTok Ads Manager dashboard. This server hooks your AI agent right up to TikTok's ad backend. You can manage campaigns, check performance numbers, and adjust spending without ever seeing that clunky dashboard. It’s direct command-line control for all your ad spend.
Your agent uses this connection to do deep dives into your account structure and run reports on everything you're doing. Here’s what it does:
Getting the Lay of the Land:
To see what's running, your agent first gets a full overview by calling list_campaigns, which returns a comprehensive list of every campaign active in your account. Need to know how many ad groups you got? It calls list_adgroups to pull that complete roster. And if you gotta check the actual creative assets—the ads themselves—it uses list_ads to give you a full listing of every individual ad associated with those campaigns.
Deep Performance Reporting:
When it comes to numbers, your agent can pull metrics at three levels: campaign, ad group, or individual ad. For the whole picture, calling get_campaign_reporting generates financial and engagement data for an entire campaign over a specified date range. Want to know how specific segments are doing? It uses get_adgroup_reporting to pull granular performance reports just for one ad group.
If you gotta check out one single creative asset, it runs get_ad_reporting, which pulls metrics like clicks and impressions specifically for that individual ad.
Controlling the Spend:
If things aren't hitting the mark, your agent can take action fast. When poor performance is detected, it immediately disables an entire campaign using pause_campaign. Conversely, if you hit pause by mistake or want to restart something strong, it uses enable_campaign to turn on a campaign that was previously paused or disabled in the system.
In short, your agent can list every ad group, pull detailed performance reports for any whole campaign or specific ad group, retrieve metrics for individual ads showing clicks and impressions, gives you a full rundown of all active campaigns, and it's got the controls to pause or enable any campaign instantly.
You get command-line access that handles all the data retrieval and the management actions.
019d7612-db28-7340-ad0f-b0f37aa94a4f 
How TikTok Ads MCP Works
- 1 Subscribe to the TikTok Ads integration on the Vinkius Marketplace. Then, create an app in the official TikTok Developers portal and get your credentials.
- 2 Pass those access keys and permissions into your AI client's configuration.
- 3 Ask your agent a question like: 'What was my ROAS last month?' or 'Pause all ads under 2x.' The agent calls the right tool, gets the data, and gives you the answer.
The bottom line is that it lets your AI client run complex ad management tasks by speaking to TikTok Ads' backend APIs directly.
Who Is TikTok Ads MCP For?
This is for performance marketers and agency account managers who spend too much time clicking through dashboards just to pull a few numbers. If you’re tired of logging into the ad platform, navigating 10 menus deep, and copy-pasting data into a spreadsheet before your morning coffee, this tool saves you hours.
Checks daily ROAS reports and uses tools like get_adgroup_reporting to isolate underperforming segments so they can adjust bids.
Manages multiple client campaigns by listing all campaigns (list_campaigns) and pausing ads across several accounts simultaneously.
Requests conversion data and ROAS metrics for specific product catalogs to determine which promotions should get more budget.
What Changes When You Connect
- Real-Time Performance Checks: You don't need to open the web dashboard just to check numbers. Running
get_adgroup_reportingallows your agent to pull specific, actionable data points (like CPC or CTR) directly into your chat window for immediate review. - Saves Time on Scaling Down: If a campaign tanks, you don't have to manually find the account and click 'Pause.' Your agent calls
pause_campaignwhen it detects ROAS dropping below 2x—saving hours of manual cleanup. - Deep Data Comparison: Compare month-over-month performance metrics easily. The server handles complex data requests, letting you ask for trends like spending changes or conversion increases without writing a SQL query.
- Full Oversight with Listing Tools: Use
list_campaignsandlist_adgroupsto get a clear inventory of everything running. You can confirm which campaigns are active before making major budget adjustments. - Budget Adjustments on the Fly: Need to shift funds? Your agent adjusts budgets and bidding strategies using dedicated tools, eliminating the need to jump through multiple settings pages in the ad platform.
Real-World Use Cases
Finding Out Why ROAS Dropped
The client notices their overall ROAS dipped last week. Instead of manually pulling reports, they ask their agent to compare campaign performance (get_campaign_reporting) from Week 1 vs. Week 2. The agent highlights that the 'Summer Collection' ad group needs attention and runs get_adgroup_reporting, showing a sudden spike in CPC.
Shutting Down Failed Ads
The marketing manager spots three ads with poor conversion rates. They ask their agent to pause all campaigns with ROAS below 1.5x. The agent runs pause_campaign and confirms the action, saving projected daily spend.
Pre-Flight Check on New Campaigns
Before a big launch day, the agency needs to know what's running. They ask their agent to list all active campaigns (list_campaigns) and then query specific performance data for each one (get_ad_reporting) to ensure everything is properly enabled.
Analyzing Audience Interests
The brand team wants to narrow down their targeting. They ask the agent to pull audience insights, which helps them identify specific demographic interests that are currently underutilized in existing ad groups (list_adgroups).
The Tradeoffs
Trying to get everything at once
Asking the agent, 'Give me all my data for last month.' The agent can't guess which tools you need; it needs specific instructions about what metrics and time frames you care about.
→
Be precise. Instead of a vague request, use get_campaign_reporting and specify the exact date range and required metrics (e.g., 'Show me impressions and ROAS for March 1st to March 31st').
Ignoring campaign status
Trying to adjust a budget on a campaign that is currently paused or disabled, leading to API errors.
→
Always run list_campaigns first. If the list shows an 'Inactive' status, you must call enable_campaign before attempting any reporting or optimization.
Using ad listings as a report
Simply calling list_ads and assuming that just because the ad exists, it’s performing well. The list only shows assets, not performance.
→
After listing ads (list_ads), you must use get_ad_reporting to pull actual metrics like clicks and conversion data. Listing is inventory; reporting is intelligence.
When It Fits, When It Doesn't
Use this server if your workflow requires reading, writing, or comparing performance data across multiple ad components (Campaigns, Ad Groups, Ads) using conversational commands. You need to know what happened and then tell the system what to do next.
Don't use it if you are doing deep creative asset development—this server only manages the live campaign structure. Also, if your primary goal is complex data visualization (like building a custom graph), pull the raw data first using get_campaign_reporting and feed that into a dedicated BI tool; don't rely on chat formatting alone.
This is ideal for day-to-day management: 'My ROAS dropped, pause it.' Not for long-term strategy building that requires external research or manual QA.
Common Questions About TikTok Ads MCP
How do I get my TikTok Ads API credentials? +
- Go to developers.tiktok.com and log in with your TikTok account.
- Click Manage Apps → Create App.
- Select Marketing API as the app type.
- Fill in the app details and submit for review.
- After approval, go to your app's page and copy the App ID and App Secret.
- Generate an Access Token by authorizing your ad account.
- Paste App ID, App Secret, and Access Token below.
Can I manage multiple ad accounts? +
Yes. Your AI agent can switch between ad accounts using their advertiser IDs, giving agencies and multi-brand teams unified campaign management.
What metrics can I track? +
Impressions, clicks, CTR, CPC, CPM, total spend, conversions, conversion rate, ROAS, video views (2s, 6s, 100%), engagement rate, and audience demographics — all filterable by date range, campaign, ad group, and individual ad.
Can I pause underperforming ads automatically? +
Yes. Ask your agent to check which ads have CPC above a threshold or ROAS below target, and it can pause those ads immediately — protecting your budget in real time.
What parameters does the `enable_campaign` tool need to launch a new ad campaign? +
The enable_campaign tool requires mandatory inputs like the target objective, the budget amount, and specific start/end dates. You'll also specify which ad groups belong to this new campaign.
When should I use the `get_adgroup_reporting` tool instead of general reports? +
Use get_adgroup_reporting when you need granular insight into performance within a specific, high-level campaign. It drills down to show which ad groups are driving results or falling short.
What should I do if I run `list_campaigns` too frequently? +
API calls are rate-limited. If you hit a limit, your agent will receive an error code. Implement a small delay between list commands or batch your requests to stay within the platform's quota.
How does `list_ads` help with micro-optimization? +
The list_ads tool retrieves performance data for individual ads. This lets you see which specific creative or ad copy is underperforming, allowing you to pause or adjust it quickly.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.