TikTok Ads MCP Server

Explore campaign performance, inspect native assets and prepare changes from your MCP client.

Local serverstdioApache-2.0

What is the TikTok Ads MCP Server?

tiktok-ads-mcp-server is an MCP project maintained in the getmcpads-com/tiktok-ads-mcp-server repository. The maintainer describes its purpose as “Explore campaign performance, inspect native assets and prepare changes from your MCP client”. Read the project documentation for the complete scope.

Installation

The documented npm package is @getmcpads/tiktok-ads-mcp-server. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares TIKTOK_ACCESS_TOKEN, TIKTOK_APP_ID. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
tiktok_health_checkRead-only health check for TikTok credentials, accessible advertisers, and advertiser info.
tiktok_list_advertisersList all TikTok advertiser accounts accessible with the current token.
tiktok_get_advertiser_infoGet detailed information for specific TikTok advertiser accounts: currency, timezone, status, balance.
tiktok_get_campaignsList campaigns for a TikTok advertiser account.
tiktok_get_adgroupsRead full native ad group configuration including targeting, custom/lookalike audience references and exclusions, geo, language, age/gender, placements…
tiktok_get_targetingRead configured ad group targeting and audience references: custom/lookalike inclusions/exclusions, geo, language, age/gender, placements, interests and…
tiktok_get_audience_reportRead TikTok AUDIENCE performance reports by age or gender at advertiser, campaign, ad group or ad level, including delivery from eligible Smart+ campaigns.
tiktok_get_adsList ads for a TikTok advertiser.
tiktok_get_insightsQuery TikTok Ads performance insights using the current native/calculated metric catalog and query planning.
tiktok_get_creativesGet creative details (video, image, text) for specific ads in a TikTok advertiser account.
tiktok_get_audiencesList custom and lookalike audiences for a TikTok advertiser account.
tiktok_search_keywordsGet keyword suggestions for TikTok Search Ads.
tiktok_validate_queryValidate a TikTok metric/dimension combination BEFORE executing.
tiktok_get_pixelsList TikTok pixels and, when permissions allow it, pixel event metadata for an advertiser.
tiktok_get_eventsDiscover pixel/app events or accessible tracking diagnostics for an advertiser.
tiktok_get_delivery_statusAggregate campaign, ad group, and ad delivery status/operation_status with simple diagnostics.
tiktok_get_async_report_statusCheck a TikTok async report task status by taskId when async report endpoints are available.
tiktok_get_video_assetsReturn ad-linked TikTok video asset metadata from ad/get and video material endpoints when available.
tiktok_get_spark_adsReturn Spark Ads context from ad fields when available, with a conservative fallback if Spark-specific fields are not supported.
tiktok_get_audience_detailsGet custom/lookalike/saved audience details where TikTok DMP endpoints are accessible.
tiktok_get_shop_catalog_diagnosticsRead-only TikTok Shop/catalog/e-commerce diagnostics.
tiktok_get_search_ads_maturityDiagnose TikTok Search Ads maturity from keyword/search-term reporting and optional keyword recommendation endpoints.
tiktok_get_creative_fatigue_recipesFind likely creative fatigue patterns from ad-level daily reporting and return read-only refresh recipes.
tiktok_get_audience_overlapRead-only audience overlap diagnostics across ad groups, custom audiences, saved audiences, and targeting fields.
tiktok_get_spark_organic_joinsJoin accessible Spark Ads fields with paid page/post reporting and optional organic identity/post endpoints when permissions allow.
tiktok_list_ad_videosList the advertiser's whole video library (file/video/ad/search): file name, duration, dimensions, signature, and publicly served preview and cover URLs.
tiktok_list_ad_imagesList the advertiser's whole image library (file/image/ad/search): file name, dimensions, signature, carousel usability, and a publicly served image URL…
tiktok_get_asset_urlsRe-resolve fresh, publicly fetchable URLs for specific TikTok library assets (file/video/ad/info and file/image/ad/info).
tiktok_get_entities_rawList TikTok campaigns, ad groups, or ads with caller-selected native fields, filtering, sorting, and pagination.
tiktok_get_report_rawRun a native TikTok BASIC or AUDIENCE synchronous report with caller-selected dimensions and metrics.
tiktok_get_targeting_catalogRead TikTok targeting and planning catalogs: locations, languages, interests, behaviors, hashtags, Search Ads keyword ideas/health, devices, carriers…
tiktok_get_read_endpointAdvanced GET-only TikTok Business API escape hatch for documented JSON read endpoints not yet modeled by a specialized MCP tool.
tiktok_get_carousel_musicGet TikTok music recommendations for exactly the uploaded images in a standard, non-catalog image ad (one card) or carousel.
tiktok_get_uploaded_videoRead one uploaded video from this advertiser’s media library.
tiktok_get_write_contextRead the exact TikTok entity, parent settings and advertiser currency/timezone before editing or building a new configuration.
tiktok_create_cta_portfolioCreate a dynamic CTA portfolio from the exact approved recommendations returned by creative/cta/recommend for this advertiser.
tiktok_create_custom_identityCreate an advertiser-owned CUSTOMIZED_USER advertising identity for Pangle or Global App Bundle.
tiktok_create_campaign_advancedCreate DISABLED classic TikTok campaign.
tiktok_update_campaign_configurationUpdate classic TikTok campaign.
tiktok_create_adgroupCreate DISABLED classic TikTok adgroup.
tiktok_update_adgroup_configurationUpdate classic TikTok adgroup.
tiktok_create_adsCreate DISABLED classic TikTok ads (video, image, carousel or authorized Spark content).
tiktok_update_adsUpdate classic TikTok ads (video, image, carousel or authorized Spark content).
tiktok_create_smart_plus_campaignCreate DISABLED upgraded Smart+ TikTok campaign.
tiktok_update_smart_plus_campaignUpdate upgraded Smart+ TikTok campaign.
tiktok_create_smart_plus_adgroupCreate DISABLED upgraded Smart+ TikTok adgroup.
tiktok_update_smart_plus_adgroupUpdate upgraded Smart+ TikTok adgroup.
tiktok_create_smart_plus_adCreate DISABLED upgraded Smart+ TikTok ads (video, image, carousel or authorized Spark content).
tiktok_update_smart_plus_adUpdate upgraded Smart+ TikTok ads (video, image, carousel or authorized Spark content).
tiktok_update_ad_statusPause or reactivate exactly one classic ad.
tiktok_update_smart_plus_campaign_statusPause or reactivate exactly one Smart+ campaign.
tiktok_update_smart_plus_adgroup_statusPause or reactivate exactly one Smart+ adgroup.
tiktok_update_smart_plus_ad_statusPause or reactivate exactly one Smart+ ad.
tiktok_update_smart_plus_material_statusPause or reactivate selected creative materials inside one upgraded Smart+ ad.
tiktok_rename_campaignRename one classic TikTok campaign.
tiktok_rename_adgroupRename one classic TikTok adgroup.
tiktok_rename_adRename one classic TikTok ad.
tiktok_upload_ad_imageImport a image from a public HTTPS media URL or base64 file (up to 5 MiB).
tiktok_upload_ad_videoImport a video from a public HTTPS media URL or base64 file (up to 5 MiB).
tiktok_update_campaign_statusPause or reactivate a TikTok campaign.
tiktok_create_campaignCreate a TikTok campaign.
tiktok_update_campaign_budgetChange a TikTok campaign budget, in the account currency.
tiktok_update_adgroup_statusPause or reactivate a TikTok ad group.
tiktok_update_adgroup_budgetChange the budget of a TikTok ad group.
URIContents

How to install the TikTok Ads MCP Server

{
  "mcpServers": {
    "tiktok-ads": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/tiktok-ads-mcp-server"
      ],
      "env": {
        "TIKTOK_ACCESS_TOKEN": "YOUR_TIKTOK_ACCESS_TOKEN",
        "TIKTOK_APP_ID": "your-app-id-here"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
TIKTOK_ACCESS_TOKENDeclared in the maintainer’s client configuration.Yes
TIKTOK_APP_IDDeclared in the maintainer’s client configuration.Yes