Docs menu

MCP tool · Brand and research

fetch_website_content

Reads the brand's website: voice, positioning, persona, claims.

What it does

Fetch and summarize the user's brand website to extract brand voice, product positioning, target persona, and key claims. Call this when you need product context for a creative strategy prompt and website_url is known in the business profile. Cache 7 days — if cached, reuses the stored summary unless the user asks to refresh.

Parameters

  • url string required

    Full URL (https://...). Use website_url from the business profile unless the user gives another.

  • force_refresh boolean optional

    Set true to bypass cache and re-crawl

  • 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_website_content",
    "arguments": {
      "url": "https://www.dropbox.com/scl/fo/example0000/nordlicht-creatives"
    }
  }
}

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_website_content","arguments":{"url":"https://www.dropbox.com/scl/fo/example0000/nordlicht-creatives"}}}'

Access and cost

PlansPro and Scale.
Scoperead: a connection or an API key without it does not see this tool (scopes).
EffectReads only: nothing is changed, in Apogee or on the ad account.
Credits150 credits per page read, free when served from the cache. A call that fails costs nothing (credits).
Rate limit600 MCP requests per 15 minutes on Pro, 1,200 on Scale (rate limits).
Daily capCounts 5 units 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.

Last updated on . The parameters, limits, credits and error codes of these pages are generated from the code of the Apogee API (contract 2026-10-06).

A question, something missing? Write to hello@apogee.ad.

Book a demo

Pick the time that suits you.

Open in a new tab

Loading the calendar…

Talk to Founder