# TikTok Ads

> Every TikTok Ads tool the MCP server exposes, with its parameters. 32 tools, 277 metrics and 16 dimensions, on a dedicated endpoint.

[Documentation](https://www.getmcpads.com/docs) / [Sources](https://www.getmcpads.com/docs/sources)

Auction reporting, creative fatigue recipes, audience overlap, Spark Ads joins.

Connection

|  |  |
| --- | --- |
| Platform id | `tiktok_ads` |
| Tool prefix | `tiktok_` |
| Account parameter | `advertiserId` |
| Dedicated endpoint | https://mcp.getmcpads.com/tiktok-ads/mcp |
| Tools | 32, 5 of which write |
| Metrics | 277 |
| Dimensions | 16 |

## Scope requested

TikTok does not pass permissions through the authorization URL. They are attached to the app in TikTok Business Center and shown to the advertiser when access is granted.

> **Note** What the gateway can change here: Pause or resume a campaign or ad group. Change a campaign or ad group budget. Create a campaign, always paused.

## Catalogues

- [Metrics](https://www.getmcpads.com/docs/sources/tiktok-ads/metrics): 277 metrics, with the field name each one maps to.
- [Dimensions](https://www.getmcpads.com/docs/sources/tiktok-ads/dimensions): 16 dimensions, with their constraints.

## Write tools (5)

Absent from the tool list on the Free plan. Each one previews by default and needs a second call with `confirm: true`.

| Tool | What it does | Kind | Discovery |
| --- | --- | --- | --- |
| [`tiktok_create_campaign`](https://www.getmcpads.com/docs/sources/tiktok-ads/tools/tiktok_create_campaign) | Create a TikTok campaign. | Write | On demand |
| [`tiktok_update_adgroup_budget`](https://www.getmcpads.com/docs/sources/tiktok-ads/tools/tiktok_update_adgroup_budget) | Change the budget of a TikTok ad group. | Write | On demand |
| [`tiktok_update_adgroup_status`](https://www.getmcpads.com/docs/sources/tiktok-ads/tools/tiktok_update_adgroup_status) | Pause or reactivate a TikTok ad group. | Write | On demand |
| [`tiktok_update_campaign_budget`](https://www.getmcpads.com/docs/sources/tiktok-ads/tools/tiktok_update_campaign_budget) | Change a TikTok campaign budget, in the account currency. | Write | On demand |
| [`tiktok_update_campaign_status`](https://www.getmcpads.com/docs/sources/tiktok-ads/tools/tiktok_update_campaign_status) | Pause or reactivate a TikTok campaign. | Write | On demand |

## Read tools (27)

Tools marked *Announced* appear in your client's tool list. The rest are reachable through `search_tools` and `run_tool`, which run the same checks.

| Tool | What it does | Kind | Discovery |
| --- | --- | --- | --- |
| [`tiktok_get_adgroups`](https://www.getmcpads.com/docs/sources/tiktok-ads/tools/tiktok_get_adgroups) | List ad groups for a TikTok advertiser. | Read | On demand |
| [`tiktok_get_ads`](https://www.getmcpads.com/docs/sources/tiktok-ads/tools/tiktok_get_ads) | List ads for a TikTok advertiser. | Read | On demand |
| [`tiktok_get_advertiser_info`](https://www.getmcpads.com/docs/sources/tiktok-ads/tools/tiktok_get_advertiser_info) | Get detailed information for specific TikTok advertiser accounts: currency, timezone, status, balance. | Read | On demand |
| [`tiktok_get_async_report_status`](https://www.getmcpads.com/docs/sources/tiktok-ads/tools/tiktok_get_async_report_status) | Check a TikTok async report task status by taskId when async report endpoints are available. | Read | On demand |
| [`tiktok_get_audience_details`](https://www.getmcpads.com/docs/sources/tiktok-ads/tools/tiktok_get_audience_details) | Get custom/lookalike/saved audience details where TikTok DMP endpoints are accessible. | Read | On demand |
| [`tiktok_get_audience_overlap`](https://www.getmcpads.com/docs/sources/tiktok-ads/tools/tiktok_get_audience_overlap) | Read-only audience overlap diagnostics across ad groups, custom audiences, saved audiences, and targeting fields. | Read | On demand |
| [`tiktok_get_audiences`](https://www.getmcpads.com/docs/sources/tiktok-ads/tools/tiktok_get_audiences) | List custom and lookalike audiences for a TikTok advertiser account. | Read | On demand |
| [`tiktok_get_campaigns`](https://www.getmcpads.com/docs/sources/tiktok-ads/tools/tiktok_get_campaigns) | List campaigns for a TikTok advertiser account. | Read | Announced |
| [`tiktok_get_creative_fatigue_recipes`](https://www.getmcpads.com/docs/sources/tiktok-ads/tools/tiktok_get_creative_fatigue_recipes) | Find likely creative fatigue patterns from ad-level daily reporting and return read-only refresh recipes. | Read | On demand |
| [`tiktok_get_creatives`](https://www.getmcpads.com/docs/sources/tiktok-ads/tools/tiktok_get_creatives) | Get creative details (video, image, text) for specific ads in a TikTok advertiser account. | Read | On demand |
| [`tiktok_get_delivery_status`](https://www.getmcpads.com/docs/sources/tiktok-ads/tools/tiktok_get_delivery_status) | Aggregate campaign, ad group, and ad delivery status/operation_status with simple diagnostics. | Read | Announced |
| [`tiktok_get_entities_raw`](https://www.getmcpads.com/docs/sources/tiktok-ads/tools/tiktok_get_entities_raw) | List TikTok campaigns, ad groups, or ads with caller-selected native fields, filtering, sorting, and pagination. | Read | On demand |
| [`tiktok_get_events`](https://www.getmcpads.com/docs/sources/tiktok-ads/tools/tiktok_get_events) | Discover pixel/app events or accessible tracking diagnostics for an advertiser. | Read | On demand |
| [`tiktok_get_insights`](https://www.getmcpads.com/docs/sources/tiktok-ads/tools/tiktok_get_insights) | Query TikTok Ads performance insights. | Read | Announced |
| [`tiktok_get_pixels`](https://www.getmcpads.com/docs/sources/tiktok-ads/tools/tiktok_get_pixels) | List TikTok pixels and, when permissions allow it, pixel event metadata for an advertiser. | Read | On demand |
| [`tiktok_get_read_endpoint`](https://www.getmcpads.com/docs/sources/tiktok-ads/tools/tiktok_get_read_endpoint) | Advanced GET-only TikTok Business API escape hatch for documented JSON read endpoints not yet modeled by a specialized MCP tool. | Read | On demand |
| [`tiktok_get_report_raw`](https://www.getmcpads.com/docs/sources/tiktok-ads/tools/tiktok_get_report_raw) | Run a native TikTok synchronous report with caller-selected dimensions and metrics. | Read | On demand |
| [`tiktok_get_search_ads_maturity`](https://www.getmcpads.com/docs/sources/tiktok-ads/tools/tiktok_get_search_ads_maturity) | Diagnose TikTok Search Ads maturity from keyword/search-term reporting and optional keyword recommendation endpoints. | Read | On demand |
| [`tiktok_get_shop_catalog_diagnostics`](https://www.getmcpads.com/docs/sources/tiktok-ads/tools/tiktok_get_shop_catalog_diagnostics) | Read-only TikTok Shop/catalog/e-commerce diagnostics. | Read | On demand |
| [`tiktok_get_spark_ads`](https://www.getmcpads.com/docs/sources/tiktok-ads/tools/tiktok_get_spark_ads) | Return Spark Ads context from ad fields when available, with a conservative fallback if Spark-specific fields are not supported. | Read | On demand |
| [`tiktok_get_spark_organic_joins`](https://www.getmcpads.com/docs/sources/tiktok-ads/tools/tiktok_get_spark_organic_joins) | Join accessible Spark Ads fields with paid page/post reporting and optional organic identity/post endpoints when permissions allow. | Read | On demand |
| [`tiktok_get_targeting_catalog`](https://www.getmcpads.com/docs/sources/tiktok-ads/tools/tiktok_get_targeting_catalog) | 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 | On demand |
| [`tiktok_get_video_assets`](https://www.getmcpads.com/docs/sources/tiktok-ads/tools/tiktok_get_video_assets) | Return ad-linked TikTok video asset metadata from ad/get and video material endpoints when available. | Read | On demand |
| [`tiktok_health_check`](https://www.getmcpads.com/docs/sources/tiktok-ads/tools/tiktok_health_check) | Read-only health check for TikTok credentials, accessible advertisers, and advertiser info. | Read | Announced |
| [`tiktok_list_advertisers`](https://www.getmcpads.com/docs/sources/tiktok-ads/tools/tiktok_list_advertisers) | List all TikTok advertiser accounts accessible with the current token. | Read | Announced |
| [`tiktok_search_keywords`](https://www.getmcpads.com/docs/sources/tiktok-ads/tools/tiktok_search_keywords) | Get keyword suggestions for TikTok Search Ads. | Read | On demand |
| [`tiktok_validate_query`](https://www.getmcpads.com/docs/sources/tiktok-ads/tools/tiktok_validate_query) | Validate a TikTok metric/dimension combination BEFORE executing. | Read | On demand |

## MCP resources

Read these with `resources/read` for machine readable metadata about the source.

| Name | URI |
| --- | --- |
| tiktok-manifest | `tiktok://manifest` |
| tiktok-recipes | `tiktok://recipes` |
| tiktok-metrics | `tiktok://metrics` |
| tiktok-dimensions | `tiktok://dimensions` |
| tiktok-compatibility | `tiktok://compatibility` |

---

This page as HTML: https://www.getmcpads.com/docs/sources/tiktok-ads
Every page under /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.