`tiktok_ads_store_preference`

Store TikTok Ads Preference

Tiktok

Description

Store a persistent preference for a TikTok ad entity. Use when you infer a recurring preference about analysis, reporting, or management. Updates existing keys. Entity type "ad_set" maps to TikTok ad groups.

Idempotent

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tiktok_ads_store_preference",
    "arguments": {
      "entity_type": "ad_account",
      "entity_id": "7012345678901234567",
      "key": "preferred_conversion_metric",
      "value": "complete_payment",
      "reason": "User wants payment completions as default metric"
    }
  }
}

hopkin tiktok preferences store

Flag	Type	Required	Description
`--entity-type`	`string`	Required	Type of ad entity: ad_account, campaign, ad_set (Meta ad sets / Google ad groups), or ad
`--entity-id`	`string`	Required	The platform entity ID (e.g. act_123456, 23842453456789)
`--key`	`string`	Required	Preference key (e.g. preferred_conversion_metric, budget_alert_threshold)
`--value`	`unknown`	Optional	Preference value — string, number, boolean, or JSON object
`--source`	`string`	Optional	Who set this preference: agent (default), user, or system
`--note`	`string`	Optional	Optional context about why this preference was set

{
  "mcpServers": {
    "tiktok-ads": {
      "url": "https://tiktok.mcp.hopkin.ai",
      "transport": "sse"
    }
  }
}

Parameters

Name	Type	Required	Description
`entity_type`	`string`	Required	Type of ad entity: ad_account, campaign, ad_set (Meta ad sets / Google ad groups), or ad `ad_account` `campaign` `ad_set` `ad`
`entity_id`	`string`	Required	The platform entity ID (e.g. act_123456, 23842453456789)minLength: 1
`key`	`string`	Required	Preference key (e.g. preferred_conversion_metric, budget_alert_threshold)minLength: 1, maxLength: 100
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (3)

Name	Type	Required	Description
`value`	`unknown`	Optional	Preference value — string, number, boolean, or JSON object
`source`	`string`	Optional	Who set this preference: agent (default), user, or system `agent` `user` `system`
`note`	`string`	Optional	Optional context about why this preference was setmaxLength: 500

Examples

Set metric

{
  "entity_type": "ad_account",
  "entity_id": "7012345678901234567",
  "key": "preferred_conversion_metric",
  "value": "complete_payment",
  "reason": "User wants payment completions as default metric"
}

hopkin tiktok preferences store --entity-type ad_account --entity-id 7012345678901234567 --key preferred_conversion_metric --value complete_payment

Set threshold

{
  "entity_type": "campaign",
  "entity_id": "1234567890123",
  "key": "budget_alert_threshold",
  "value": 0.8,
  "reason": "Alert at 80% budget"
}

hopkin tiktok preferences store --entity-type campaign --entity-id 1234567890123 --key budget_alert_threshold --value 0.8