search_meta_ad_library

What it does

Parameters

• page_id string optional

  Meta page ID of the competitor (preferred). Resolves to their ad library directly.

• search_terms string optional

  Keyword search across all pages (use when page_id unknown).

• countries array of strings optional

  ISO country codes (e.g. ["FR","BE"]). Default ["ALL"].

• limit number optional

  Max ads to return (default 20, max 50).

• 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):

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_meta_ad_library",
    "arguments": {
      "page_id": "100000000000001",
      "search_terms": "120200000000000001"
    }
  }
}

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":"search_meta_ad_library","arguments":{"page_id":"100000000000001","search_terms":"120200000000000001"}}}'

Access and cost

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.
• 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.
• load_reference: Loads one of Apogee's reference documents (audit frameworks, checklists, benchmarks).