How to Connect TikTok Ads to Cursor via MCP

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → TikTok Ads, paste your credentials, mint an MCP API key and you're done. No Docker, no git clone, no local server.

TikTok Ads + Cursor

Let your AI analyse your TikTok ads: spend, impressions, clicks and conversions by campaign, ad group, ad, day or audience, plus campaigns, Smart+ campaigns, audiences, pixels and the creative library. Can pause or turn on campaigns, ad groups and ads and change campaign budgets once you switch those tools on and confirm.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

TIKTOK_ADS_API_HOST, TIKTOK_ADS_ACCESS_TOKEN, TIKTOK_ADS_ADVERTISER_ID

Step 1 — Get credentials

1. Sign in to the TikTok API for Business developer portal at https://business-api.tiktok.com/portal with a TikTok for Business account that can access your ad account, and click Become a Developer.
2. Under My Apps → Create an app, enter a name, a description and an Advertiser redirect URL (any https page of yours: you only copy a code from its address), and tick the permission scopes Ad Account Management, Ads Management, Reporting and Audience Management, plus Pixel Management and Creative Management for those tools. TikTok reviews new apps, usually within two or three business days.
3. Once the app is approved, copy its App ID and Secret into TIKTOK_ADS_APP_ID and TIKTOK_ADS_APP_SECRET. Both are optional: the connector only uses them to list the ad accounts your token covers.
4. Open the app's Advertiser authorization URL, sign in, tick the ad accounts and confirm. Your browser lands on the redirect URL with auth_code=... in the address bar. The code works once and expires after an hour.
5. Exchange the code right away for a long-lived access token. This is a one-time step:

   curl -X POST https://business-api.tiktok.com/open_api/v1.3/oauth2/access_token/ -H "Content-Type: application/json" -d '{"app_id":"<App ID>","secret":"<Secret>","auth_code":"<auth_code>"}'
   

   Paste data.access_token from the answer into TIKTOK_ADS_ACCESS_TOKEN and one of the data.advertiser_ids into TIKTOK_ADS_ADVERTISER_ID. The token does not expire; it only stops working when the authorization is revoked or the app secret is reset.
6. Set TIKTOK_ADS_API_HOST to https://business-api.tiktok.com, install the connector and run tiktok_ads_get_advertiser_info to check the account.

Sandbox: to try it without real spend, open your app in the developer portal → Sandbox, create a sandbox ad account and generate its token there; no review is needed. Use that token and the sandbox advertiser id, and set TIKTOK_ADS_API_HOST to https://sandbox-ads.tiktok.com. Sandbox accounts deliver no ads and report no real data.

One ad account per connector: every tool works on the ad account in TIKTOK_ADS_ADVERTISER_ID. A token often covers several accounts, and tiktok_ads_list_authorized_advertisers lists them. Install the connector again for each further account.

Status and budget changes are off by default: tiktok_ads_update_campaign_status, tiktok_ads_update_ad_group_status, tiktok_ads_update_ad_status and tiktok_ads_update_campaign_budget are switched off at install, because turning something on starts spending at once. Switch them on per tool if you want the AI to pause ads or change budgets. It then names the campaign, ad group or ad, the current and the new value, and waits for your yes. An ad only delivers when the ad, its ad group and its campaign are all on. Budgets are amounts in the account currency (50 means 50.00), and TikTok refuses a budget below its minimum or below 105% of what has already been spent. The connector never creates campaigns or ads.

Reports: tiktok_ads_get_report returns spend, impressions, clicks, conversions and more per campaign, ad group, ad or for the whole account, by day or by hour, or broken down by age, gender, country or placement. Daily rows cover up to 30 days per request, so the AI splits longer periods; totals without a time breakdown can span up to a year. Dates follow the ad account's timezone and amounts its currency.

Common errors: TikTok reports errors as a code in an otherwise normal answer, and the connector turns them into a clear error. 40001: the app or token lacks permission for this account or action, so authorize the ad account again with the needed scopes. 40104 or 40105: the token is invalid, expired or revoked, or belongs to another account; generate a new one. 40100: too many requests, wait a moment. 40300: TikTok does not know the advertiser id.

The connector does not create or edit campaigns, ad groups, ads or audiences, upload creatives, manage Business Center or cover TikTok Shop.

Step 2 — Install the adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Add the connector in Cursor

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Cursor reads MCP servers from ~/.cursor/mcp.json. Add this entry:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Create an MCP API key in AnythingMCP under MCP Servers → your server → API keys, and paste it in place of YOUR_MCP_API_KEY.
2. Save the file and restart Cursor.
3. Open Cursor → Settings → MCP and check that anythingmcp is listed and connected.
4. Start chatting: the agent can now call the TikTok Ads tools.

Available tools

Example prompts

• "How much did we spend on TikTok last week, and which campaign had the lowest cost per conversion?"
• "Show daily spend, clicks and conversions for each campaign over the last 30 days."
• "Break down last month's results by age and gender."
• "Is our TikTok Pixel still receiving purchase events? Compare the last 7 days with the week before."

FAQ

Does Cursor support custom MCP servers on the free tier? Yes, MCP is available on Hobby, Pro and Business plans.

Next steps

• Connector landing page
• Connect to Claude
• Connect to ChatGPT