Ad Library

Facebook Ad Library in Claude

Meta's Ad Library, as tools your assistant can call - find a page, list what it is running, and read the angles out of the creative.

The Facebook Ad Library is Meta's public archive of ads currently running across Facebook and Instagram. MCP Ads exposes it through the official Ad Library API, so you can ask about a competitor instead of paging through the web interface.

What a call looks like

These are real tool names from the live server, with the shape of what they return.

YouFind the Ad Library page for this brand.
Toolmeta_ad_library_find_advertiser
{
  "matches": [
    { "page_id": "8623794015", "page_name": "Example Brand", "ads_in_archive": 34 }
  ]
}
YouShow me what they are running in Ireland.
Toolmeta_ad_library_advertiser_ads
{
  "ads": [
    { "ad_archive_id": "70112...", "started": "2026-08-02",
      "platforms": ["facebook", "instagram"], "body": "Try it free for 14 days" }
  ]
}
YouHow far is that campaign reaching?
Toolmeta_ad_library_eu_reach
{
  "eu_total_reach": 412885,
  "note": "Reach figures are published for EU/UK delivery only."
}

What the Ad Library covers

Every ad currently running on Facebook and Instagram is in the archive. What the API returns depends on where the ad was delivered, and that distinction catches people out.

  • EU and UK - ordinary commercial ads, plus reach and targeting disclosures
  • Everywhere else - political and social-issue ads only
  • Ad creative, copy, start date, and the platforms it runs on
  • Reach figures for EU deliveries, which no other public source gives you

Why a US search comes back empty

It is not a broken connection and it does not mean the brand runs no ads. Meta restricts commercial ad data in the API to EU and UK delivery. For US competitors, Google's Ads Transparency Center is the better source and is covered by the same connector.

Access and verification

Meta gates Ad Library API access on the token holder's identity verification. MCP Ads runs the lookups through one verified identity, so you do not have to complete Meta's ID check yourself to use it.

Questions

Is the Facebook Ad Library API free?

Meta does not charge for it, but it requires an identity-verified access token. MCP Ads handles that side, so there is nothing for you to verify.

Can I see how much a competitor is spending?

Only for political and social-issue ads, where Meta publishes spend ranges. Commercial ads show reach for EU deliveries but not spend - no public source has commercial spend figures.

Related

Connect an account and try it

Add MCP Ads to Claude or ChatGPT with one URL, authorise an ad account in the browser, and ask it something.