MCP tool · Brand and research
trigger_comment_sync
Fetches fresh comments from Meta (1 to 5 minutes).
What it does
Trigger a Comment Analysis sync to fetch fresh ad comments from Meta. Use this when fetch_ad_comments returns stale data (sync_status="stale_suggest_refresh") or no data at all. The sync runs asynchronously (takes 1-5 minutes depending on the number of ads). After triggering, tell the user the sync has started and that fresh comments will be available shortly — or in a follow-up conversation. Choose period_days: 30 (default, faster) or 90 (deeper, slower). The synced comments are shared with the Comment Analysis page.
Parameters
-
ad_account_idstring requiredMeta ad account id (act_…), from list_ad_accounts
-
period_daysconstant optionalHow far back to sync comments. 30 days (faster, default) or 90 days (deeper).
Example
Your assistant calls it for you when you ask in your own words. What it sends (MCP tools/call, JSON-RPC 2.0):
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "trigger_comment_sync",
"arguments": {
"ad_account_id": "act_1234567890"
}
}
}The same call over HTTP with an API key, for an MCP client of your own (an assistant that signs in sends its OAuth token instead):
curl -X POST https://app.apogee.ad/mcp \
-H "Authorization: Bearer $APOGEE_API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"trigger_comment_sync","arguments":{"ad_account_id":"act_1234567890"}}}'Access and cost
| Plans | Pro and Scale. |
|---|---|
| Scope | read: a connection or an API key without it does not see this tool (scopes). |
| Effect | Changes Apogee only (imports, uploads, settings, comment syncs, AI drafts): nothing on the ad account. |
| Credits | 10 credits per sync started. A call that fails costs nothing (credits). |
| Rate limit | 600 MCP requests per 15 minutes on Pro, 1,200 on Scale (rate limits). |
| Daily cap | Counts 5 units toward the 2,000 units one API key or assistant connection can use in 24 hours. |
Related tools
Brand and research: Context for creative strategy: your business profile, your comments, reviews and competitors.
get_business_profile: What Apogee knows about the brand of this ad account: website, margin, targets (CAC, ROAS).update_business_profile: Saves what you told the assistant about the brand, so it does not ask again. Apogee's data only.fetch_website_content: Reads the brand's website: voice, positioning, persona, claims.fetch_ad_comments: The comments of your ads, as Comment Analysis stores them.fetch_customer_reviews: Public reviews of the brand, positive or negative.search_reddit: Reddit threads on a topic: the customers' own words and pain points.search_meta_ad_library: Competitors' ads in the Meta Ad Library (texts only).load_reference: Loads one of Apogee's reference documents (audit frameworks, checklists, benchmarks).