MCP tool · Brand and research
get_business_profile
What Apogee knows about the brand of this ad account: website, margin, targets (CAC, ROAS).
What it does
Read the stored business profile for the current ad account. Returns known fields (website_url, brand_name, category, business_type, target_cac, target_roas, target_mer, product_margin_pct, ltv, repeat_purchase_rate_pct, primary_objective, etc.) plus the list of fields still missing. USE THIS FIRST when a prompt requires business context (e.g. scaling decisions, customer review analysis). If required fields are missing, ASK the user for them in plain language, then call update_business_profile to persist.
Parameters
-
ad_account_idstring requiredMeta ad account id (act_…), from list_ad_accounts
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": "get_business_profile",
"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":"get_business_profile","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 | 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. |
Related tools
Brand and research: Context for creative strategy: your business profile, your comments, reviews and competitors.
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).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).