TikTok Ads MCP server
TikTok Ads MCP server: 35 read tools, 30 opt-in preview-first writes.
0 stars550 downloads/wk
Reviews
Write oneNobody has reviewed TikTok Ads yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
TikTok Ads tools (40, 7 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
tiktok_create_campaignwrite actionCreate a TikTok campaign. It is always created disabled and there is no option to create it running. Previews by default.
tiktok_get_adgroupsRead 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.
tiktok_get_adsList ads for a TikTok advertiser. Returns ad ID, name, operation status, and creative info.
tiktok_get_advertiser_infoGet detailed information for specific TikTok advertiser accounts: currency, timezone, status, balance.
tiktok_get_asset_urlsRe-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.
tiktok_get_async_report_statusCheck a TikTok async report task status by taskId when async report endpoints are available. No report creation or mutation is performed.
tiktok_get_audience_detailsGet custom/lookalike/saved audience details where TikTok DMP endpoints are accessible. Read-only only.
tiktok_get_audience_overlapRead-only audience overlap diagnostics across ad groups, custom audiences, saved audiences, and targeting fields.
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. Multiple demographics return separate reports, not a joint distribution. Explicit pagination and native provider errors; no inference of configured targeting or Custom Audience membership.
tiktok_get_audiencesList custom and lookalike audiences for a TikTok advertiser account.
tiktok_get_campaignsList campaigns for a TikTok advertiser account. Returns campaign ID, name, status, budget, and objective.
tiktok_get_carousel_musicGet 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.
tiktok_get_creative_fatigue_recipesFind likely creative fatigue patterns from ad-level daily reporting and return read-only refresh recipes. Does not create, edit, or upload creatives.
tiktok_get_creativesGet creative details (video, image, text) for specific ads in a TikTok advertiser account.
tiktok_get_delivery_statusAggregate campaign, ad group, and ad delivery status/operation_status with simple diagnostics.
tiktok_get_entities_rawList 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.
tiktok_get_eventsDiscover pixel/app events or accessible tracking diagnostics for an advertiser. Uses best-effort endpoint checks plus reporting dimensions as fallback.
tiktok_get_insightsQuery 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 breakdo
tiktok_get_pixelsList TikTok pixels and, when permissions allow it, pixel event metadata for an advertiser. Falls back with explicit warnings when endpoints are unavailable.
tiktok_get_read_endpointAdvanced 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.
tiktok_get_report_rawwrite actionRun 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.
tiktok_get_search_ads_maturityDiagnose TikTok Search Ads maturity from keyword/search-term reporting and optional keyword recommendation endpoints. Read-only diagnostics only.
tiktok_get_shop_catalog_diagnosticsRead-only TikTok Shop/catalog/e-commerce diagnostics. Tries catalog reporting first, then Shop auction metrics, and returns endpoint warnings when catalog permissions are unavailable.
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_spark_organic_joinsJoin accessible Spark Ads fields with paid page/post reporting and optional organic identity/post endpoints when permissions allow. Read-only only.
tiktok_get_targetingRead 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
tiktok_get_targeting_catalogRead TikTok targeting and planning catalogs: locations, languages, interests, behaviors, hashtags, Search Ads keyword ideas/health, devices, carriers, contextual tags, content exclusions, and time zones.
tiktok_get_uploaded_videoRead one uploaded video from this advertiser\u2019s media library. Returns ready only after its media information is available with positive duration and dimensions. Does not upload again.
tiktok_get_video_assetsReturn ad-linked TikTok video asset metadata from ad/get and video material endpoints when available.
tiktok_get_write_contextwrite actionRead the exact TikTok entity, parent settings and advertiser currency/timezone before editing or building a new configuration. Read-only.
tiktok_health_checkRead-only health check for TikTok credentials, accessible advertisers, and advertiser info. Never returns tokens or secrets.
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 signed for roughly thirty days (image_url_expires_at gives the exact instant).
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. Every TikTok URL is signed and expires after roughly six hours: re-resolve with tiktok_get_asset_urls before use.
tiktok_list_advertisersList the TikTok advertiser accounts accessible with the current token, limited to TIKTOK_ADVERTISER_IDS. Returns advertiser ID, name, and status.
tiktok_search_keywordsGet keyword suggestions for TikTok Search Ads. Returns recommended keywords with search volume estimates.
tiktok_update_adgroup_budgetwrite actionChange the budget of a TikTok ad group. Amount in the account currency, sent as is. Previews by default.
tiktok_update_adgroup_statuswrite actionPause or reactivate a TikTok ad group. Previews by default.
tiktok_update_campaign_budgetwrite actionChange a TikTok campaign budget, in the account currency. Previews by default.
tiktok_update_campaign_statuswrite actionPause or reactivate a TikTok campaign. Previews by default.
tiktok_validate_queryValidate a TikTok metric/dimension combination BEFORE executing. Checks dimension grouping rules, lifetime compatibility, and metric/dimension compatibility.
Public scan report
scanner v0.1.10 · 2026-10-30 · same rubric, same numbers if you re-run it
- Code scan9 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 4 days ago15/15
- Maintainer identitynamespace and repository owner differ; website matches verified namespace6/10
How TikTok Ads compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 80/100
- higher than 60% of 48,255 servers
- Tools
- 40
- the typical server has 7
- Tools that change things
- 18%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 550
- more than 89% of 12,191 servers with a package
What its tools let an agent do: 33 read · 7 change
Release history: 4 versions in the registry since 2026-08-30, latest 2026-10-26, typically one every 24 days.
Install TikTok Ads in Claude Code, Cursor or VS Code
Runs npx -y @getmcpads/tiktok-ads-mcp-server on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add tiktok-ads -- npx -y @getmcpads/tiktok-ads-mcp-server
Grade history
- 2026-10-30restoreC → Bscore 80
TikTok Ads: common questions
- Is TikTok Ads MCP server safe?
- Mostly: it is graded B (80/100). Read the TikTok Ads safety report
- How do I install TikTok Ads?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does TikTok Ads need an API key?
- Yes. The registry entry asks for
TIKTOK_ACCESS_TOKEN,TIKTOK_APP_SECRET. - Is TikTok Ads maintained?
- The last commit was 9 days ago (2026-10-26). The latest release is v2.1.1.
- What can I use instead of TikTok Ads?
- Servers from other publishers that do the same job: AdLoop MCP server.
- How does TikTok Ads compare with other MCP servers?
- safety score 80/100 (higher than 60% of 48,255 servers); tools 40 (the typical server has 7); tools that change things 18% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to TikTok Ads
Same job from other publishers: the closest match first, then the best rated.
- AdLoopGoogle Ads, Reddit Ads, GA4 and Tag Manager in your AI client, with a preview before every change.not reviewedEstablishedA