TikTok Ads MCP Server

Create DISABLED classic TikTok adgroup. No option to launch active. Native objective/format eligibility is enforced by TikTok. Local preview by default. No automatic retry; advertiser ownership is checked before applying.

Create DISABLED classic TikTok ads (video, image, carousel or authorized Spark content). No option to launch active. Native objective/format eligibility is enforced by TikTok. Local preview by default. No automatic retry; advertiser ownership is checked before applying.

Create a TikTok campaign. It is always created disabled and there is no option to create it running. Previews by default.

Create DISABLED classic TikTok campaign. No option to launch active. Native objective/format eligibility is enforced by TikTok. Local preview by default. No automatic retry; advertiser ownership is checked before applying.

Create a dynamic CTA portfolio from the exact approved recommendations returned by creative/cta/recommend for this advertiser. Use its result.creative_portfolio_id as ad_configuration.call_to_action_id for Smart+ Spark website/app ads. Creates no ad and changes no delivery status. Local preview by default. No automatic retry; advertiser ownership is checked before applying.

Create an advertiser-owned CUSTOMIZED_USER advertising identity for Pangle or Global App Bundle. Does not create a public TikTok profile or enable delivery. Custom identities cannot be used for new TikTok-placement ads. Uses TikTok’s default avatar. Local preview by default. No automatic retry; advertiser ownership is checked before applying.

Create DISABLED upgraded Smart+ TikTok ads (video, image, carousel or authorized Spark content). No option to launch active. Native objective/format eligibility is enforced by TikTok. Local preview by default. No automatic retry; advertiser ownership is checked before applying.

Create DISABLED upgraded Smart+ TikTok adgroup. No option to launch active. Native objective/format eligibility is enforced by TikTok. Local preview by default. No automatic retry; advertiser ownership is checked before applying.

Create DISABLED upgraded Smart+ TikTok campaign. No option to launch active. Native objective/format eligibility is enforced by TikTok. Local preview by default. No automatic retry; advertiser ownership is checked before applying.

Read full native ad group configuration including targeting, custom/lookalike audience references and exclusions, geo, language, age/gender, placements, interests/behaviors, budget and schedule. Set smartPlus:true for upgraded Smart+ targeting_spec. Missing fields are unknown, not unrestricted targeting. Paginated.

List ads for a TikTok advertiser. Returns ad ID, name, operation status, and creative info.

Get detailed information for specific TikTok advertiser accounts: currency, timezone, status, balance.

Re-resolve fresh, publicly fetchable URLs for specific TikTok library assets (file/video/ad/info and file/image/ad/info). Call at display or download time: every TikTok media URL is signed and expires.

Check a TikTok async report task status by taskId when async report endpoints are available. No report creation or mutation is performed.

Get custom/lookalike/saved audience details where TikTok DMP endpoints are accessible. Read-only only.

Read-only audience overlap diagnostics across ad groups, custom audiences, saved audiences, and targeting fields.

Read TikTok AUDIENCE performance reports by age or gender at advertiser, campaign, ad group or ad level, including delivery from eligible Smart+ campaigns. Multiple demographics return separate reports, not a joint distribution. Explicit pagination and native provider errors; no inference of configured targeting or Custom Audience membership.

List custom and lookalike audiences for a TikTok advertiser account.

List campaigns for a TikTok advertiser account. Returns campaign ID, name, status, budget, and objective.

Get TikTok music recommendations for exactly the uploaded images in a standard, non-catalog image ad (one card) or carousel. Verifies each image is carousel-usable. Read-only; select a returned music_id in the approval preview and use the same images in the ad. Music is for use on TikTok only.

Find likely creative fatigue patterns from ad-level daily reporting and return read-only refresh recipes. Does not create, edit, or upload creatives.

Get creative details (video, image, text) for specific ads in a TikTok advertiser account.

Aggregate campaign, ad group, and ad delivery status/operation_status with simple diagnostics.

List TikTok campaigns, ad groups, or ads with caller-selected native fields, filtering, sorting, and pagination. This GET-only escape hatch exposes newly released entity fields without waiting for the MCP's curated schemas.

Discover pixel/app events or accessible tracking diagnostics for an advertiser. Uses best-effort endpoint checks plus reporting dimensions as fallback.

Query TikTok Ads performance insights using the current native/calculated metric catalog and query planning. Use tiktok://metrics resource to see available metrics. Use tiktok://dimensions for dimensions. Age/gender dimensions route automatically to AUDIENCE reports via tiktok_get_audience_report, including campaign/ad group levels. Other dimensions use the BASIC planner. Multiple audience breakdowns remain separate reports, never joined.

List TikTok pixels and, when permissions allow it, pixel event metadata for an advertiser. Falls back with explicit warnings when endpoints are unavailable.

Advanced GET-only TikTok Business API escape hatch for documented JSON read endpoints not yet modeled by a specialized MCP tool. Relative v1.3 paths and JSON-compatible query parameters are validated; OAuth, mutations, downloads, and lead-record paths are blocked.

Run a native TikTok BASIC or AUDIENCE synchronous report with caller-selected dimensions and metrics. AUDIENCE supports demographics such as age/gender at campaign/adgroup levels; tiktok_get_audience_report provides a guided path. Use when a current API field is not yet in tiktok://metrics; unlike tiktok_get_insights, this tool does not calculate aliases or auto-split incompatible selections.

Diagnose TikTok Search Ads maturity from keyword/search-term reporting and optional keyword recommendation endpoints. Read-only diagnostics only.

Read-only TikTok Shop/catalog/e-commerce diagnostics. Tries catalog reporting first, then Shop auction metrics, and returns endpoint warnings when catalog permissions are unavailable.

Return Spark Ads context from ad fields when available, with a conservative fallback if Spark-specific fields are not supported.

Join accessible Spark Ads fields with paid page/post reporting and optional organic identity/post endpoints when permissions allow. Read-only only.

Read configured ad group targeting and audience references: custom/lookalike inclusions/exclusions, geo, language, age/gender, placements, interests and behaviors. Supports classic and upgraded Smart+ (smartPlus:true), preserving targeting_spec and automatic targeting settings. Does not infer delivered audiences or hidden Smart+ signals. Use tiktok_get_audiences for audience names/types and tiktok_get_audience_report for delivered demographics.

Read TikTok targeting and planning catalogs: locations, languages, interests, behaviors, hashtags, Search Ads keyword ideas/health, devices, carriers, contextual tags, content exclusions, and time zones.

Read one uploaded video from this advertiser’s media library. Returns ready only after its media information is available with positive duration and dimensions. Does not upload again.

Return ad-linked TikTok video asset metadata from ad/get and video material endpoints when available.

Read the exact TikTok entity, parent settings and advertiser currency/timezone before editing or building a new configuration. Read-only.

Read-only health check for TikTok credentials, accessible advertisers, and advertiser info. Never returns tokens or secrets.

List the advertiser's whole image library (file/image/ad/search): file name, dimensions, signature, carousel usability, and a publicly served image URL signed for roughly thirty days (image_url_expires_at gives the exact instant).

List the advertiser's whole video library (file/video/ad/search): file name, duration, dimensions, signature, and publicly served preview and cover URLs. Every TikTok URL is signed and expires after roughly six hours: re-resolve with tiktok_get_asset_urls before use.

List all TikTok advertiser accounts accessible with the current token. Returns advertiser ID, name, and status.

Rename one classic TikTok ad. Does not change its budget, creative content or status. Local preview by default. No automatic retry; advertiser ownership is checked before applying.

Rename one classic TikTok adgroup. Does not change its budget, creative content or status. Local preview by default. No automatic retry; advertiser ownership is checked before applying.

Rename one classic TikTok campaign. Does not change its budget, creative content or status. Local preview by default. No automatic retry; advertiser ownership is checked before applying.

Get keyword suggestions for TikTok Search Ads. Returns recommended keywords with search volume estimates.

Pause or reactivate exactly one classic ad. Local preview by default. No automatic retry; advertiser ownership is checked before applying.

Change the budget of a TikTok ad group. Amount in the account currency, sent as is. Previews by default.

Update classic TikTok adgroup. Status is unchanged. Native objective/format eligibility is enforced by TikTok. Local preview by default. No automatic retry; advertiser ownership is checked before applying.

Pause or reactivate a TikTok ad group. Previews by default.

Update classic TikTok ads (video, image, carousel or authorized Spark content). Status is unchanged. Native objective/format eligibility is enforced by TikTok. Local preview by default. No automatic retry; advertiser ownership is checked before applying.

Change a TikTok campaign budget, in the account currency. Previews by default.

Update classic TikTok campaign. Status is unchanged. Native objective/format eligibility is enforced by TikTok. Local preview by default. No automatic retry; advertiser ownership is checked before applying.

Pause or reactivate a TikTok campaign. Previews by default.

Update upgraded Smart+ TikTok ads (video, image, carousel or authorized Spark content). Status is unchanged. Native objective/format eligibility is enforced by TikTok. Local preview by default. No automatic retry; advertiser ownership is checked before applying.

Pause or reactivate exactly one Smart+ ad. Local preview by default. No automatic retry; advertiser ownership is checked before applying.

Update upgraded Smart+ TikTok adgroup. Status is unchanged. Native objective/format eligibility is enforced by TikTok. Local preview by default. No automatic retry; advertiser ownership is checked before applying.

Pause or reactivate exactly one Smart+ adgroup. Local preview by default. No automatic retry; advertiser ownership is checked before applying.

Update upgraded Smart+ TikTok campaign. Status is unchanged. Native objective/format eligibility is enforced by TikTok. Local preview by default. No automatic retry; advertiser ownership is checked before applying.

Pause or reactivate exactly one Smart+ campaign. Local preview by default. No automatic retry; advertiser ownership is checked before applying.

Pause or reactivate selected creative materials inside one upgraded Smart+ ad. Parent campaign, ad group and ad statuses are unchanged; the shared library asset is not modified. Local preview by default. No automatic retry; advertiser ownership is checked before applying.

Import a image from a public HTTPS media URL or base64 file (up to 5 MiB). A single returned media ID is exposed at media.id, with the native receipt preserved in result. TikTok may process it asynchronously; acceptance is not proof the media is ready. Local preview by default. No automatic retry; advertiser ownership is checked before applying.

Import a video from a public HTTPS media URL or base64 file (up to 5 MiB). A single returned media ID is exposed at media.id, with the native receipt preserved in result. TikTok may process it asynchronously; acceptance is not proof the media is ready. Local preview by default. No automatic retry; advertiser ownership is checked before applying.

Validate a TikTok metric/dimension combination BEFORE executing. Checks dimension grouping rules, lifetime compatibility, and metric/dimension compatibility.