TikTok Ads MCP API reference
Every TikTok Ads tool the MCP server exposes, with its parameters. 58 tools, 277 metrics and 16 dimensions, on a dedicated endpoint.
63 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
- 58, 27 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 (27)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 DISABLED classic TikTok adgroup. | Write | On demand |
tiktok_ | Create DISABLED classic TikTok ads (video, image, carousel or authorized Spark content). | Write | On demand |
tiktok_ | Create a TikTok campaign. | Write | On demand |
tiktok_ | Create DISABLED classic TikTok campaign. | Write | On demand |
tiktok_ | Create DISABLED upgraded Smart+ TikTok ads (video, image, carousel or authorized Spark content). | Write | On demand |
tiktok_ | Create DISABLED upgraded Smart+ TikTok adgroup. | Write | On demand |
tiktok_ | Create DISABLED upgraded Smart+ TikTok campaign. | Write | On demand |
tiktok_rename_ad | Rename one classic TikTok ad. | Write | On demand |
tiktok_ | Rename one classic TikTok adgroup. | Write | On demand |
tiktok_ | Rename one classic TikTok campaign. | Write | On demand |
tiktok_ | Pause or reactivate exactly one classic ad. | Write | On demand |
tiktok_ | Change the budget of a TikTok ad group. | Write | On demand |
tiktok_ | Update classic TikTok adgroup. | Write | On demand |
tiktok_ | Pause or reactivate a TikTok ad group. | Write | On demand |
tiktok_ | Update classic TikTok ads (video, image, carousel or authorized Spark content). | Write | On demand |
tiktok_ | Change a TikTok campaign budget, in the account currency. | Write | On demand |
tiktok_ | Update classic TikTok campaign. | Write | On demand |
tiktok_ | Pause or reactivate a TikTok campaign. | Write | On demand |
tiktok_ | Update upgraded Smart+ TikTok ads (video, image, carousel or authorized Spark content). | Write | On demand |
tiktok_ | Pause or reactivate exactly one Smart+ ad. | Write | On demand |
tiktok_ | Update upgraded Smart+ TikTok adgroup. | Write | On demand |
tiktok_ | Pause or reactivate exactly one Smart+ adgroup. | Write | On demand |
tiktok_ | Update upgraded Smart+ TikTok campaign. | Write | On demand |
tiktok_ | Pause or reactivate exactly one Smart+ campaign. | Write | On demand |
tiktok_ | Pause or reactivate selected creative materials inside one upgraded Smart+ ad. | Write | On demand |
tiktok_ | Import a image from a public HTTPS media URL or base64 file (up to 5 MiB). | Write | On demand |
tiktok_ | Import a video from a public HTTPS media URL or base64 file (up to 5 MiB). | Write | On demand |
Read tools (31)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_ | Re-resolve fresh, publicly fetchable URLs for specific TikTok library assets (file/video/ad/info and file/image/ad/info). | 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 the exact TikTok entity, parent settings and advertiser currency/timezone before editing or building a new configuration. | Read | On demand |
tiktok_ | Read-only health check for TikTok credentials, accessible advertisers, and advertiser info. | Read | Announced |
tiktok_ | 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). | Read | Announced |
tiktok_ | List the advertiser's whole video library (file/video/ad/search): file name, duration, dimensions, signature, and publicly served preview and cover URLs. | 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:/ |