Skip to Content
MCPToolsMeta Ads Analysis

Meta Ads Analysis

Give it a Facebook page, get back the ads that page is currently running.

Tool
meta_ads_analysis
Cost
0.5 credits
Category
Ads Intelligence
Required input
page_id
Returns
Active ads from the page, across all countries

What it does

  • Returns the active ads running from a Facebook/Meta page, across all countries.
  • page_id accepts either a Page ID or a full page URL. Either works.
  • ad_type filters the category of ad. Default is "all ads".
  • max_results is unusually constrained: 10 to 20, default 10. Most SyncGTM tools go to 100. This one does not — do not ask for 50.

Built for competitor ad intelligence: what a competitor is promoting right now, in what wording, and to which markets.


Parameters

ParameterTypeRequiredNotes
page_idstringYesPage ID or full page URL
ad_typestringNo"all ads" (default), "issues politics or elections", "properties", "employment", "financial products and services"
max_resultsnumberNo10–20, default 10

How to use it

Connect the MCP server

Follow the setup guide for your client. Browser sign-in, no API key.

Pull a page’s ads

Analyse Meta ads for this Facebook page URL, max 20 results.

Read a competitor’s positioning

Get the active Meta ads for these three competitor pages, 20 each. Summarise what each one leads with and where the messages overlap.

Narrow by category

Get Meta ads for this page with ad_type set to employment, 20 results.

Example prompts

Ask your clientWhat you get back
”Meta ads for this Facebook page, 20 results”Up to 20 active ads
”What are these three competitors promoting on Meta?”Ads per page, summarised
”Show only their hiring ads”Filtered with ad_type: "employment"
”What B2B ads is Acme running?”Use b2b_ads_search instead

Best prompting practices

  • Ask for 20, not 50. The ceiling is 20. Requesting more is the most common error on this tool.
  • Pass the full page URL when you do not know the numeric Page ID — it is accepted directly.
  • Leave ad_type alone unless you have a reason. "all ads" is the default and the widest net; the other values narrow to specific regulated categories.
  • Run each competitor as its own call. One page per call keeps the comparison clean.
  • Ask for the positioning, not the ad copy. “What do they lead with, and what do they never mention” is the usable output.

Output

{ "page_id": "123456789", "ads": [ { "headline": "Close the books in two days.", "body": "Automate month-end for finance teams.", "started_at": "2026-07-14" } ] }

Credits and limits

0.5 credits per call, max_results capped at 20. Run check_credits (free) before a large batch.

An empty result means the page has no active ads right now — it does not mean the page never advertises. Re-run it later if you are tracking a competitor’s campaign cadence.


ToolUse it instead when
b2b_ads_searchYou want B2B ads by company domain — 0.5 credits
similarweb_insightsYou want the traffic channel mix behind the spend — 2 credits
instagram_profile_postsYou want organic Instagram content, not paid ads
company_product_launchYou want what they just shipped, not what they promote — 1 credit

Next steps


Keep learning

Two courses take these tools past the reference page — clustered by GTM job, then chained into workflows.