@getmcpads/tiktok-ads-mcp-server

MCPcommunity
v1.0.2GetMCPAdsApache-2.0Updated 24d agonpmGitHub

Open-source MCP server for the TikTok Business API. 27 read tools and 5 write tools that preview before they apply, 277 metrics, 16 dimensions, keyword research. Self-hosted, bring your own token.

Works in
ClaudeCursorCopilotGemini

Inferred from the transports this listing declares (stdio). A client not listed here hasn’t been ruled out — it just isn’t something Forge can confirm.

Automatically indexed from public sources. Not yet verified by the developer on Forge.Claim this listing →
103Downloads/wk
24d agoLast update
Needs 1 credential before it runs
  • TIKTOK_ACCESS_TOKENAPI keyrequired

    TikTok Business API access token.

  • TIKTOK_APP_SECRETAPI keyoptional

    App secret, for endpoints needing app authentication.

Declared by the author in the official MCP registry. Forge does not store, broker, or ever see these values — the config below is scaffolded with placeholders you fill in locally.

Package
AuthorGetMCPAds
LicenseApache-2.0
Version1.0.2
Sourcenpm+mcp-registry
Trust Status
B
60/100Good
Listed in Forge index+10/10
Publisher identity verified+0/20
Publisher: run `forge publish` from the package repo to claim ownership
Ed25519 publish signature+0/5
Included automatically when the publisher runs `forge publish`
Domain verification+0/5
Publisher: host /.well-known/forge.json on the package homepage with { "publisher": "<github-login>" }
npm Trusted Publishing (Sigstore)+0/5
Publish from GitHub Actions with --provenance so the attestation binds this package to this repo
npm maintainer match+0/5
Earned once your identity is verified above and that login is an npm maintainer of this package
CVE scan · clean+30/30
Static analysis · clean+20/20
Paste into Claude Code, Cursor, or any AI assistant to fix all gaps
StatusCommunity-indexed
PublisherUnverified
SignatureUnsigned
Domain
Provenance
Dependencies✓ 60 resolved+ · none vulnerable
Tool surface32 tools · none privileged
Security scan✓ Cleanv1.0.2 · 23d agoHow well does this scan work?
EvalsNone
IndexedAug 31, 2026

Verification confirms publisher identity (repo ownership), not code safety. The security scan covers known CVEs and suspicious install scripts.

Tools

32 tools · none privileged
Statically extracted from the published packagev1.0.2 · 23d ago

Read out of the source npm actually ships, at scan time. The package was never executed. Tools registered dynamically at runtime, or hidden inside bundled or minified code, can be missed — so this is a floor on the tool surface, not a complete census of it.

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.

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.

No input schema was published for this tool.

tiktok_get_report_rawRun a native TikTok synchronous report with caller-selected dimensions and metrics. 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.

Run a native TikTok synchronous report with caller-selected dimensions and metrics. 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.

No input schema was published for this tool.

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.

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.

No input schema was published for this tool.

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.

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.

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

tiktok_get_adgroupsList ad groups for a TikTok advertiser. Returns targeting, budget, optimization goal, and schedule info.

List ad groups for a TikTok advertiser. Returns targeting, budget, optimization goal, and schedule info.

No input schema was published for this tool.

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

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

No input schema was published for this tool.

tiktok_get_insightsQuery TikTok Ads performance insights. Supports 400+ metrics with intelligent query planning. Use tiktok://metrics resource to see available metrics. Use tiktok://dimensions for dimensions. The query planner automatically splits requests when dimension combinations are incompatible (only 1 ID dimen…

Query TikTok Ads performance insights. Supports 400+ metrics with intelligent query planning. Use tiktok://metrics resource to see available metrics. Use tiktok://dimensions for dimensions. The query planner automatically splits requests when dimension combinations are incompatible (only 1 ID dimen…

No input schema was published for this tool.

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

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

No input schema was published for this tool.

tiktok_get_audiencesList custom and lookalike audiences for a TikTok advertiser account.

List custom and lookalike audiences for a TikTok advertiser account.

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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.

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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.

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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.

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.

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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.

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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.

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

No input schema was published for this tool.

tiktok_update_campaign_statusPause or reactivate a TikTok campaign. Previews by default: without confirm: true, the tool describes the change without applying it.

Pause or reactivate a TikTok campaign. Previews by default: without confirm: true, the tool describes the change without applying it.

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

tiktok_update_adgroup_budgetChange the budget of a TikTok ad group, in the account currency. Previews by default.

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

No input schema was published for this tool.

32 of 32 tools published a description.

Tool names and descriptions are written by the publisher and shown verbatim as inert text. They are the strings an MCP client passes to a model, so Forge scans them for prompt-injection patterns — any finding appears with the security scan above. “Privileged” is a keyword match on the tool name, not an audit of what the tool does: a benign-sounding name can still do anything.

About

Open-source MCP server for the TikTok Business API. 27 read tools and 5 write tools that preview before they apply, 277 metrics, 16 dimensions, keyword research. Self-hosted, bring your own token.

Keywords
mcpmcp-servermodel-context-protocoltiktok-adstiktok-business-apitiktok-marketing-apiadvertisingmarketing-analyticsclaudechatgptcursorai-agent
Alternatives
Comparing tool surfaces…

Dependency tree

What one Forge scan resolved from npm metadata on 2026-08-31 — observed resolution, not a publisher declaration.

60 packages resolved · 2 direct · none carrying advisories Resolution stops at depth 4 and 60 packages.

The crawl stopped at the depth-4 limit. Anything below that level was never resolved.

The crawl stopped at the 60-package limit. The rest of the tree was never resolved.

36 more resolved packages are not drawn here (display cap: 24). Every dependency carrying an advisory is drawn regardless of the cap. Full inventory (CycloneDX SBOM)

Declared but not resolved

54 declared dependencies never landed in the tree. They are missing from Forge's resolution, not from the package.

+42 more not listed. The counts by reason above cover all of them.

Not followed: peerDependencies. This tree covers runtime dependencies only, so anything those pull in was never resolved.

Topics

Related in analytics & dashboards