Log inSubmit server
TikTok Ads logo

TikTok Ads

Query TikTok Ads performance, targeting, audiences, creatives, assets, and diagnostics through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install TikTok Ads

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "tiktok-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/tiktok-ads-mcp-server"
      ],
      "env": {
        "TIKTOK_ACCESS_TOKEN": "YOUR_VALUE_HERE",
        "TIKTOK_APP_ID": "YOUR_VALUE_HERE",
        "TIKTOK_APP_SECRET": "YOUR_VALUE_HERE",
        "TIKTOK_ADVERTISER_ID": "YOUR_VALUE_HERE",
        "TIKTOK_BC_ID": "YOUR_VALUE_HERE",
        "TIKTOK_ENABLE_WRITES": "YOUR_VALUE_HERE",
        "LOG_LEVEL": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y @getmcpads/tiktok-ads-mcp-server

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 4d ago.

Overview

The TikTok Ads MCP server connects MCP clients to the TikTok for Business API for advertiser, campaign, reporting, audience, creative, and asset data. It provides read tools for performance insights, native reports, targeting, delivery diagnostics, pixels, events, and media libraries, plus write tools that preview changes before applying them. Query validation and planning help avoid unsupported TikTok metric and dimension combinations. Use it when an agent needs to inspect or manage TikTok advertising accounts through a local MCP connection.

Use cases

  • Review campaign and ad performance
  • Inspect targeting and audience overlap
  • Validate reporting queries before execution
  • Diagnose delivery, pixel, and catalog issues
  • List and refresh TikTok creative asset URLs

Key features

  • TikTok advertiser and campaign data access
  • Performance and audience reporting
  • Targeting, audience, and delivery diagnostics
  • Creative and media library inspection
  • Metric-dimension query validation
  • Preview-first write operations

Tools64

What TikTok Ads lets your agent do. Expand a tool for its parameters.

Self-reported~1.7k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

5/6 checks healthy over the last 41d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 16d ago via OSV.dev · @getmcpads/tiktok-ads-mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads711Package downloads in the last 30 days.
Last commit1mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed64Callable tools this server registers over MCP.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How TikTok Ads works

What the TikTok Ads MCP server does

The TikTok Ads MCP server exposes TikTok for Business advertising data and operations through MCP. It can discover accessible advertiser accounts, retrieve account details, list campaigns, ad groups, and ads, and inspect the configuration behind ad group targeting. Targeting data includes geography, language, age, gender, placements, interests, behaviors, and custom or lookalike audience references.

Reporting tools cover campaign performance and audience breakdowns by age or gender. The server also provides access to creatives, TikTok pixels, pixel or app events, delivery status, custom and lookalike audiences, Spark Ads context, and TikTok Shop or catalog diagnostics. Search Ads workflows include keyword suggestions and maturity diagnostics. Asset tools list video and image libraries and can resolve fresh public URLs for selected assets.

How it works

Requests run through the TikTok API using the advertiser access granted to the configured token. The health check verifies credentials, identifies reachable advertisers, and reports advertiser information without exposing the token. A default advertiser ID can be configured, or calls can identify the advertiser explicitly.

The TikTok Ads MCP server includes query validation for native metrics and dimensions. Its planning logic can split an incompatible reporting request into valid API calls and combine the results. Raw entity and report tools allow callers to select native fields, filters, sorting, pagination, dimensions, and metrics when a higher-level tool does not cover a request. API responses are checked using TikTok's application-level status code rather than HTTP status alone.

Write operations are disabled unless explicitly enabled. When available, they return a preview first; a later confirmed request is required before a live change is applied.

Setup and configuration

The standalone release requires Node.js 22.12 or newer. Install from source with npm ci and npm run build, then configure the MCP client to run node with the absolute path to dist/cli.js. The repository also documents an npx configuration for supported clients.

Required environment variables are TIKTOK_ACCESS_TOKEN and TIKTOK_APP_ID. The token must belong to the TikTok developer application, and the advertiser accounts must be authorized for that token. Optional settings include TIKTOK_APP_SECRET, TIKTOK_ADVERTISER_ID, TIKTOK_BC_ID, TIKTOK_ENABLE_WRITES, and LOG_LEVEL. Reporting and read permissions are needed for read tools; campaign management permissions are needed for writes. Business Center and catalog permissions may be needed for catalog diagnostics.

Tools and capabilities

  • Check credentials and accessible advertiser accounts.
  • Read campaigns, ad groups, ads, creatives, targeting, audiences, pixels, and events.
  • Query performance, audience, native BASIC, and native AUDIENCE reports.
  • Inspect delivery status, async report tasks, Spark Ads, Search Ads, catalogs, and creative fatigue patterns.
  • List video and image assets and refresh asset URLs.
  • Validate metric and dimension combinations before reporting calls.
  • Preview supported advertising changes before confirmation.

Limitations and notes

Access depends on TikTok permissions and advertiser authorization. Some endpoints, including audience details, Spark Ads fields, organic joins, event diagnostics, and catalog data, may return less information when the account lacks the relevant permissions or when TikTok does not expose the endpoint. Asset URLs are publicly fetchable but signed URLs have limited validity; image responses include an expiration timestamp.

The TikTok Ads MCP server is the standalone native API tool release. Hosted product features and MCP Apps interfaces described by the project are separate from this repository. Review the current tool schemas before reusing saved arguments, especially after upgrades.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about TikTok Ads

TikTok Ads is an MCP server that connects MCP clients to the TikTok for Business API. Its main tools list advertisers, campaigns, ad groups, ads, audiences, creatives, and assets; query performance and audience reports; inspect targeting, pixels, events, and delivery; validate report queries; and preview supported account changes.

Install it from the repository with Node.js 22.12 or newer, then run `npm ci` and `npm run build`. Configure your MCP client to launch the built `dist/cli.js`, or use the documented `npx` setup with the required TikTok environment variables.

It requires `TIKTOK_ACCESS_TOKEN` and `TIKTOK_APP_ID`. The token must be authorized for the advertiser accounts you want to access. `TIKTOK_APP_SECRET` is optional for endpoints that need app authentication.

Yes, TikTok Ads works with Cursor through its project MCP configuration. Add the server command and the `TIKTOK_ACCESS_TOKEN` and `TIKTOK_APP_ID` environment variables to `.cursor/mcp.json`.

No, write tools are disabled by default. Set `TIKTOK_ENABLE_WRITES=1` to register them, and supported changes return a preview before a confirmed request applies anything to the live account.

Related MCP servers

All in Monitoring All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewTikTok Ads AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/tiktok-ads?style=directory)](https://allmcps.com/mcp/tiktok-ads)
HTML Embed
<a href="https://allmcps.com/mcp/tiktok-ads"><img src="https://allmcps.com/api/badge/tiktok-ads?style=directory" alt="TikTok Ads on AllMCPs" /></a>