TikTok Ads MCP Server (read + write)

An MCP server for the TikTok API for Business (Marketing API v1.3). Use it from Claude, ChatGPT, Cursor, Codex or any MCP client to report on TikTok ad accounts, build and change campaigns, ad groups and ads (including Upgraded Smart+), upload creatives, and manage audiences, pixels and catalogs.

It's maintained by AI Shopping Feeds and offers:

• the advertiser workflow on the current API: ad accounts and Business Centers, campaigns, ad groups and ads, Upgraded Smart+, creatives, audiences, targeting lookups, pixels, catalogs and reports

• safety for real budgets: dry-run, confirm words, spend guards, before-snapshots, an audit log, read-only mode and tool groups

• an escape hatch for every other Marketing API endpoint, with writes behind a confirm word

TikTok runs its own hosted TikTok for Business MCP Server (about 400 tools, no developer app needed, sign-in renewed every 30 days, 6 requests a second per tool). This one runs on your machine with your own developer app, and adds dry-run, confirm words, spend guards, an audit log, read-only mode and a smaller tool set. More in docs/terms-and-data.md. Not affiliated with or endorsed by TikTok.

Part of the AI Shopping Feeds MCP family: Google Ads · Google Merchant Centre · Google Analytics · YouTube Studio · Amazon Ads · Apple Ads · Microsoft Ads · TikTok Ads · Pinterest Ads · Snapchat Ads · OpenAI Ads · AppLovin.

Let your agent set it up

Paste this into Claude Code, Codex, Cursor or any agent that can read web pages and edit files:

Set up the TikTok Ads MCP server for me by following https://raw.githubusercontent.com/AI-Shopping-Feeds/tiktok-ads-mcp/main/skills/tiktok-ads-mcp/SKILL.md

The agent checks whether it's already connected, installs the runner if you agree, walks you through the TikTok developer account, developer app and advertiser authorisation, adds the server to your client's config without touching your other servers, and checks it works by calling tiktok_ads_health_check.

The same file is an Agent Skill, so your agent can keep it as a guide to using the tools well. For Claude Code, copy the folder into your skills:

git clone --depth 1 https://github.com/AI-Shopping-Feeds/tiktok-ads-mcp.git /tmp/tiktok-ads-mcp
cp -r /tmp/tiktok-ads-mcp/skills/tiktok-ads-mcp ~/.claude/skills/

Other agents that support skills load the same skills/tiktok-ads-mcp folder from their own skills directory.

Related MCP server: OpenAI Ads MCP server

What it can do

65 tools, all prefixed tiktok_ads_. The full list is in docs/tools.md.

Read

Write

Upcoming TikTok change: from 1 January 2027 TikTok's Campaign Management endpoints stop creating non-Search Legacy Manual Flow campaigns, ad groups and ads for Sales, App Promotion and Lead Generation. This server already creates those through Upgraded Smart+, and can still read, change, pause and delete legacy campaigns. Details in docs/tools.md.

Safety

• Dry-run (TIKTOK_ADS_DRY_RUN=true or tiktok_ads_set_dry_run) records writes in the audit log and returns what would be sent, without sending it. Reads and reports still work.

• Confirm words. Deletes need confirm="DELETE". Enabling delivery, batches over TIKTOK_ADS_BULK_THRESHOLD (10), bid or budget rises over TIKTOK_ADS_MAX_INCREASE_PCT (20%) or unknown current values, values over TIKTOK_ADS_MAX_BID / TIKTOK_ADS_MAX_BUDGET, and raw writes need confirm="APPLY". Without it nothing is sent and the agent gets the reasons and before/after values to show you.

• Paused by default. New campaigns and ad groups are created paused unless you ask otherwise.

• Audit log of every write with a before-snapshot, in ~/.tiktok-ads-mcp/logs/audit.jsonl (owner-only), pruned after TIKTOK_ADS_AUDIT_RETENTION_DAYS (30). tiktok-ads-mcp purge deletes it and the stored token (--revoke also revokes the token at TikTok).

• Read-only mode (TIKTOK_ADS_READ_ONLY=true) and tool groups (TIKTOK_ADS_TOOL_GROUPS) limit what's loaded; TIKTOK_ADS_ALLOWED_ADVERTISER_IDS limits which ad accounts it touches.

• Rate limits: requests are spaced to TIKTOK_ADS_MAX_QPS (10, TikTok's Basic level) and throttled calls back off and retry.

• Local only by default: the HTTP transports refuse non-loopback addresses unless TIKTOK_ADS_ALLOW_REMOTE=true.

• Terms, data handling and what to check before using it for clients: docs/terms-and-data.md.

Supported clients

Setup

1. Install uv

The server runs with uvx from uv (brew install uv on macOS) and needs Python 3.11 or later. It installs straight from this repository:

uvx --from git+https://github.com/AI-Shopping-Feeds/tiktok-ads-mcp.git tiktok-ads-mcp version

Pin a release by adding @vX.Y.Z to the URL.

2. Get credentials

1. TikTok For Business account and developer registration at the TikTok API for Business portal. TikTok reviews developers in about three business days and needs a company email and website.

2. Developer app with the scopes you need and the advertiser redirect URL http://localhost:8765/callback. App review takes two to three business days. Note the App ID and Secret.

3. Authorise with the TikTok For Business user that manages the ad accounts:

   TIKTOK_ADS_APP_ID=123456789 TIKTOK_ADS_APP_SECRET=your-app-secret \
     uvx --from git+https://github.com/AI-Shopping-Feeds/tiktok-ads-mcp.git tiktok-ads-mcp auth

   It saves a long-term access token to ~/.tiktok-ads-mcp/secrets/tiktok-ads-token.json (owner-only) and lists the ad account IDs it can manage.

Step by step, with timings: docs/setup-tiktok-ads-api.md.

3. Add it to your client

Replace the placeholders. Keep your other servers in each file. The token is read from ~/.tiktok-ads-mcp/secrets/ (or set TIKTOK_ADS_TOKEN_FILE), so it doesn't go in the client config.

Claude Code

claude mcp add --scope user tiktok-ads \
  --env TIKTOK_ADS_APP_ID=123456789 \
  --env TIKTOK_ADS_APP_SECRET=your-app-secret \
  --env TIKTOK_ADS_ADVERTISER_ID=123456789 \
  --env TIKTOK_ADS_DRY_RUN=true \
  -- uvx --from git+https://github.com/AI-Shopping-Feeds/tiktok-ads-mcp.git tiktok-ads-mcp

Claude Desktop, Cursor, Gemini CLI, Windsurf (and VS Code under servers)

{
  "mcpServers": {
    "tiktok-ads": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/AI-Shopping-Feeds/tiktok-ads-mcp.git", "tiktok-ads-mcp"],
      "env": {
        "TIKTOK_ADS_APP_ID": "123456789",
        "TIKTOK_ADS_APP_SECRET": "your-app-secret",
        "TIKTOK_ADS_ADVERTISER_ID": "123456789",
        "TIKTOK_ADS_DRY_RUN": "true"
      }
    }
  }
}

Desktop apps often can't find uvx on the PATH; if the server doesn't start, use the full path from which uvx as the command. To keep the secret out of client configs, put the variables in ~/.tiktok-ads-mcp/.env instead.

Codex (~/.codex/config.toml)

[mcp_servers.tiktok-ads]
command = "uvx"
args = ["--from", "git+https://github.com/AI-Shopping-Feeds/tiktok-ads-mcp.git", "tiktok-ads-mcp"]
env = { TIKTOK_ADS_APP_ID = "123456789", TIKTOK_ADS_APP_SECRET = "your-app-secret", TIKTOK_ADS_ADVERTISER_ID = "123456789", TIKTOK_ADS_DRY_RUN = "true" }

4. Check it works

Restart or reload the client, then ask it to "check the TikTok Ads connection and list my ad accounts". It should call tiktok_ads_health_check. When you're happy with the previews, set TIKTOK_ADS_DRY_RUN=false.

Configuration

Settings are read from the environment, then --env FILE or ./.env, then ~/.tiktok-ads-mcp/.env. CLI: tiktok-ads-mcp run (default), auth, purge, describe, version.

Example prompts

Which TikTok campaigns spent the most last week, and what was their cost per result?

Pause every ad group in the "Summer sale" campaign with a cost per purchase above 40. Dry-run first and show me the table.

Create an Upgraded Smart+ Sales campaign for example.com with a 50 a day budget, paused, using the three newest videos.

Raise the daily budget of my best-performing Traffic ad group by 15% from tomorrow.

More docs

• All tools, confirm words and the 2027 change

• Getting TikTok API access, step by step

• Terms, data handling and comparison with TikTok's MCP server

• Agent skill: setup and usage guide for agents

• Changelog and security policy

Contributing and licence

Issues and pull requests are welcome on this repository. See CONTRIBUTING.md.

Licensed under the MIT License.

Try out AI Shopping Feeds, our shopping feed management tool (including Google Shopping feeds).