`meta_ads_store_preference`

Store Meta Ads Preference

Description

Store a persistent preference for a Meta ad entity. Use when you infer a recurring preference about analysis, reporting, or management. Updates existing keys.

Idempotent

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "meta_ads_store_preference",
    "arguments": {
      "entity_type": "ad_account",
      "entity_id": "act_123",
      "key": "preferred_conversion_metric",
      "value": "ROAS",
      "reason": "User wants ROAS as default metric"
    }
  }
}

hopkin meta 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": {
    "meta-ads": {
      "url": "https://mcp.hopkin.ai/meta-ads/mcp",
      "transport": "sse"
    }
  }
}

Set metric
Set threshold

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": "act_123",
  "key": "preferred_conversion_metric",
  "value": "ROAS",
  "reason": "User wants ROAS as default metric"
}

hopkin meta preferences store --entity-type ad_account --entity-id act_123 --key preferred_conversion_metric --value ROAS

Set threshold

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

hopkin meta preferences store --entity-type campaign --entity-id 456 --key budget_alert_threshold --value 0.8