MCP tool · Brand and research

`fetch_customer_reviews`

Public reviews of the brand, positive or negative.

Read only Scope: read Pro and Scale plans Credits: Free*

What it does

Search public customer reviews about the brand (Trustpilot, Judge.me, Google Reviews, etc.) via web_search with targeted queries. Use rating_filter="positive" for 4-5 star reviews (what customers love) or "negative" for 1-3 star reviews (objections, gaps — the best angles for creatives). Requires brand_name in the business profile. Cache 2 days.

Parameters

brand_name string optional

Brand name. Defaults to business_profile.brand_name if omitted.
rating_filter string optional

"positive" = 4-5 stars, "negative" = 1-3 stars, "all" = everything. Default "all".

One of positive, negative, all
force_refresh boolean optional
ad_account_id string optional

Meta ad account id (act_…), from list_ad_accounts

Matches ^(act_)?\d{1,32}$

Example

Your assistant calls it for you when you ask in your own words. What it sends (MCP tools/call, JSON-RPC 2.0):

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "fetch_customer_reviews",
    "arguments": {
      "brand_name": "Nordlicht | Spring launch",
      "rating_filter": "positive"
    }
  }
}

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

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":"fetch_customer_reviews","arguments":{"brand_name":"Nordlicht | Spring launch","rating_filter":"positive"}}}'

Access and cost

Plans	Pro and Scale.
Scope	`read`: a connection or an API key without it does not see this tool (scopes).
Effect	Reads only: nothing is changed, in Apogee or on the ad account.
Credits	Free up to the daily free reads (5,000 a day on Pro, 10,000 on Scale), then 1 credit per read. 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 1 unit toward the 2,000 units one API key or assistant connection can use in 24 hours.

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.
trigger_comment_sync: Fetches fresh comments from Meta (1 to 5 minutes).
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).

What it does

Parameters

Example

Access and cost

Related tools