TikTok Ads

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 the TikTok advertiser accounts accessible with the current token, limited to TIKTOK_ADVERTISER_IDS. 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 the TikTok ad account (advertiser) itself. Works for ad accounts created in a Business Center, by a Business Center admin. Does not change billing, company details or delivery. 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.

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

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

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

Pause or reactivate a TikTok campaign. Previews by default.

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.