tiktok_ads_list_campaigns

List TikTok Campaigns

Tiktok

Description

List TikTok ad campaigns for an advertiser. Shows name, status, objective, and budget.

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tiktok_ads_list_campaigns",
    "arguments": {}
  }
}
hopkin tiktok campaigns 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.
--campaignstringOptionalFetch a single campaign by ID.
--campaign-idsarrayOptionalFetch specific campaigns by IDs.
--statusarrayOptionalFilter by primary status.
--searchstringOptionalSearch campaigns 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 (7)
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.
campaign_id string Optional Fetch a single campaign by ID.
campaign_ids array Optional Fetch specific campaigns by IDs.
status array Optional Filter by primary status.
search string Optional Search campaigns by name (case-insensitive).