TikTok Ads MCP API reference
Every TikTok Ads tool the MCP server exposes, with its parameters. 32 tools, 277 metrics and 16 dimensions, on a dedicated endpoint.
37 rows
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 requestedLink to this section
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.
CataloguesLink to this section
Write tools (5)Link to this section
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 a TikTok campaign. | Write | On demand |
tiktok_ | Change the budget of a TikTok ad group. | Write | On demand |
tiktok_ | Pause or reactivate a TikTok ad group. | Write | On demand |
tiktok_ | Change a TikTok campaign budget, in the account currency. | Write | On demand |
tiktok_ | Pause or reactivate a TikTok campaign. | Write | On demand |
Read tools (27)Link to this section
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_ | List ad groups for a TikTok advertiser. | Read | On demand |
tiktok_get_ads | List ads for a TikTok advertiser. | Read | On demand |
tiktok_ | Get detailed information for specific TikTok advertiser accounts: currency, timezone, status, balance. | Read | On demand |
tiktok_ | Check a TikTok async report task status by taskId when async report endpoints are available. | Read | On demand |
tiktok_ | Get custom/lookalike/saved audience details where TikTok DMP endpoints are accessible. | Read | On demand |
tiktok_ | Read-only audience overlap diagnostics across ad groups, custom audiences, saved audiences, and targeting fields. | Read | On demand |
tiktok_ | List custom and lookalike audiences for a TikTok advertiser account. | Read | On demand |
tiktok_ | List campaigns for a TikTok advertiser account. | Read | Announced |
tiktok_ | Find likely creative fatigue patterns from ad-level daily reporting and return read-only refresh recipes. | Read | On demand |
tiktok_ | Get creative details (video, image, text) for specific ads in a TikTok advertiser account. | Read | On demand |
tiktok_ | Aggregate campaign, ad group, and ad delivery status/operation_status with simple diagnostics. | Read | Announced |
tiktok_ | List TikTok campaigns, ad groups, or ads with caller-selected native fields, filtering, sorting, and pagination. | Read | On demand |
tiktok_ | Discover pixel/app events or accessible tracking diagnostics for an advertiser. | Read | On demand |
tiktok_ | Query TikTok Ads performance insights. | Read | Announced |
tiktok_ | List TikTok pixels and, when permissions allow it, pixel event metadata for an advertiser. | Read | On demand |
tiktok_ | 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_ | Run a native TikTok synchronous report with caller-selected dimensions and metrics. | Read | On demand |
tiktok_ | Diagnose TikTok Search Ads maturity from keyword/search-term reporting and optional keyword recommendation endpoints. | Read | On demand |
tiktok_ | Read-only TikTok Shop/catalog/e-commerce diagnostics. | Read | On demand |
tiktok_ | Return Spark Ads context from ad fields when available, with a conservative fallback if Spark-specific fields are not supported. | Read | On demand |
tiktok_ | Join accessible Spark Ads fields with paid page/post reporting and optional organic identity/post endpoints when permissions allow. | Read | On demand |
tiktok_ | 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_ | Return ad-linked TikTok video asset metadata from ad/get and video material endpoints when available. | Read | On demand |
tiktok_ | Read-only health check for TikTok credentials, accessible advertisers, and advertiser info. | Read | Announced |
tiktok_ | List all TikTok advertiser accounts accessible with the current token. | Read | Announced |
tiktok_ | Get keyword suggestions for TikTok Search Ads. | Read | On demand |
tiktok_ | Validate a TikTok metric/dimension combination BEFORE executing. | Read | On demand |
MCP resourcesLink to this section
Read these with resources/read for machine readable metadata about the source.
| Name | URI |
|---|---|
| tiktok-manifest | tiktok:/ |
| tiktok-recipes | tiktok://recipes |
| tiktok-metrics | tiktok://metrics |
| tiktok-dimensions | tiktok:/ |
| tiktok-compatibility | tiktok:/ |