tiktok_ads_list_ads

List TikTok Ads

Tiktok

Description

List TikTok ads for an advertiser. Shows name, status, creative, and ad group association.

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tiktok_ads_list_ads",
    "arguments": {}
  }
}
hopkin tiktok ads list
FlagTypeRequiredDescription
--limitintegerOptionalMaximum number of results to return (1–100). Default: 20.
--cursorstringOptionalOpaque pagination cursor from a previous response.
--refreshbooleanOptionalForce a fresh fetch bypassing the cache.
--advertiser-idstringRequiredTikTok advertiser ID.
--adstringOptionalFetch a single ad by ID.
--ad-idsarrayOptionalFetch specific ads by IDs.
--campaign-idsarrayOptionalFilter by parent campaign IDs.
--adgroup-idsarrayOptionalFilter by parent ad group IDs.
--statusarrayOptionalFilter by primary status.
--searchstringOptionalSearch ads by name (case-insensitive).
{
  "mcpServers": {
    "tiktok-ads": {
      "url": "https://mcp.hopkin.ai/tiktok-ads/mcp",
      "transport": "sse"
    }
  }
}

No example prompts available.

Parameters

NameTypeRequiredDescription
advertiser_id string Required TikTok advertiser ID.minLength: 1
reason string Required Why this tool call is neededminLength: 1, maxLength: 500
Optional parameters (9)
NameTypeRequiredDescription
limit integer Optional Maximum number of results to return (1–100). Default: 20.min: 1, max: 100
cursor string Optional Opaque pagination cursor from a previous response.
refresh boolean Optional Force a fresh fetch bypassing the cache.
ad_id string Optional Fetch a single ad by ID.
ad_ids array Optional Fetch specific ads by IDs.
campaign_ids array Optional Filter by parent campaign IDs.
adgroup_ids array Optional Filter by parent ad group IDs.
status array Optional Filter by primary status.
search string Optional Search ads by name (case-insensitive).