Skip to main content

Set up the TikTok Ads MCP server

The TikTok Ads MCP server gives AI agents read-only access to TikTok ad campaigns, ad groups, ads, and performance reports through the TikTok Marketing API. This guide covers creating a TikTok Marketing API app, configuring OAuth, and connecting it to MintMCP.

Prerequisites​

Create a TikTok Marketing API app​

  1. Go to business-api.tiktok.com/portal and sign in with your TikTok for Business account.
  2. Click Become a Developer and complete the registration form with your contact and company details (first time only) — TikTok's developer registration guide covers each field.
  3. Go to My Apps and click Create an App.
My Apps link in the TikTok for Business developer portal navigation
  1. In the Create New App form, enter an app name and description.
Create New App form with app name, description, advertiser redirect URL, and scope of permission fields

  1. Set Advertiser redirect URL to:

    https://app.mintmcp.com/oauth/callback

  2. Under Scope of permission, select these grant categories:

    Grant categoryWhat it enables
    Ad Account ManagementRead advertiser account and Business Center data
    Ads ManagementRead campaigns, ad groups, and ads
    ReportingRead performance metrics and reports

  3. Click Submit. The app enters TikTok's review queue with Pending status — approval typically takes 2–3 business days, and production ad accounts can't authorize your app until it's approved.

App list row showing the new app with Pending review status

Copy the App ID and Secret​

  1. In My Apps, click View on your app to open its Basic Information page.
Basic Information page showing the App ID, Secret, and advertiser authorization URL
  1. Copy the App ID and Secret. You'll need them in the next step — keep the Secret private.

Add TikTok Ads to MintMCP​

  1. In MintMCP, go to MCP store → Manage store.

  2. Find the TikTok Ads connector and click to install it.

  3. Open the connector's OAuth settings and enter:

    SettingValue
    Authorization URLhttps://business-api.tiktok.com/portal/auth
    Token URLhttps://business-api.tiktok.com/open_api/v1.3/oauth2/access_token/
    Client IDApp ID from your TikTok app's Basic Information page
    Client SecretSecret from your TikTok app's Basic Information page

  4. Confirm the Redirect URL shown in the connector's OAuth settings matches the URL you set in the TikTok app (https://app.mintmcp.com/oauth/callback). They must be identical, or authentication fails.

  5. Click Save.

The first time a user calls a tool, MintMCP directs them to sign in with TikTok and select which ad accounts to share. After authorization, TikTok tokens don't expire unless revoked, so users won't need to re-authorize unless they disconnect.

Security considerations​

  • The App Secret acts as a client credential — anyone who has it can initiate OAuth flows on behalf of your app. Store it securely and don't share it.
  • Each user authenticates individually, so tool calls run against that user's own TikTok for Business access, limited by their account permissions.
  • Production ad accounts require your app to pass TikTok's review before users can authorize. Reviewers check that the scopes requested match your stated use case.
  • TikTok tokens are long-lived. Users should revoke the MintMCP app's access from their TikTok for Business account if they leave the organization.

Next steps​