Servers Playground How we check Add a server Log in

Meta Ad Library Spend MCP by AdSpendSpy

Working · 1.1 s

com.adspendspy/adspendspyv1.0.2 Domain verified

Facebook and Meta Ad Library ads with estimated ad spend per ad, top landing pages and alerts.

Marketing & SEO

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://www.adspendspy.com/mcp

X-API-Key (required)

AdSpendSpy API key. Create a key in Account Settings → API Keys.

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

check_brands_tracked Read-only

Check whether each string Meta page ID is actively tracked by your account.

page_idsarray, required

Meta Ad Library Spend MCP by AdSpendSpy MCP server | mcptry

Tools (17)

check_brands_tracked

Check whether each string Meta page ID is actively tracked by your account.

read-only

Argument	Type	Description
page_ids*	array

Input schema (JSON)

{
  "type": "object",
  "required": [
    "page_ids"
  ],
  "properties": {
    "page_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[0-9]{5,25}$",
        "description": "Meta advertiser page ID, kept as a string."
      },
      "maxItems": 100,
      "minItems": 1
    }
  },
  "additionalProperties": false
}

compare_advertisers

Compare 2 to 6 tracked advertisers side by side: category, active ads where known, estimated 30-day spend range and one top ad each. A name AdSpendSpy does not track is listed as not tracked and never replaced by a similar brand. No sign-in needed.

read-only

Argument	Type	Description
brands	array
page_ids	array

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "brands": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 100,
        "minLength": 2
      },
      "maxItems": 6,
      "minItems": 1
    },
    "page_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[0-9]+$",
        "maxLength": 25,
        "minLength": 3
      },
      "maxItems": 6,
      "minItems": 1
    }
  },
  "additionalProperties": false
}

find_similar_advertisers

List up to six tracked advertisers similar to a brand (same Facebook page category or niche), each with category, active ads where known, estimated 30-day spend range and one top ad. No sign-in needed. Pass page_id when known, otherwise the exact brand name.

read-only

Argument	Type	Description
brand	string	Exact brand or advertiser name as the user wrote it, e.g. "Gymshark". Used only when no page_id is given; never matched to a differently named brand.
limit	integer
page_id	string	Numeric Meta page ID of the advertiser, as returned in earlier results. Preferred when known.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "brand": {
      "type": "string",
      "maxLength": 100,
      "minLength": 2,
      "description": "Exact brand or advertiser name as the user wrote it, e.g. \"Gymshark\". Used only when no page_id is given; never matched to a differently named brand."
    },
    "limit": {
      "type": "integer",
      "default": 6,
      "maximum": 6,
      "minimum": 1
    },
    "page_id": {
      "type": "string",
      "pattern": "^[0-9]+$",
      "maxLength": 25,
      "minLength": 3,
      "description": "Numeric Meta page ID of the advertiser, as returned in earlier results. Preferred when known."
    }
  },
  "additionalProperties": false
}

get_ad_details

Retrieve one ad of an advertiser you actively track by its internal AdSpendSpy ad ID (internal_ad_id), not its Meta ad ID. Saved lists and favorites do not retain MCP ad access after you remove a tracked brand on the website.

read-only

Argument	Type	Description
ad_id*	integer	Internal AdSpendSpy ad ID (internal_ad_id in ad listings); never a Meta ad ID.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "ad_id"
  ],
  "properties": {
    "ad_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Internal AdSpendSpy ad ID (internal_ad_id in ad listings); never a Meta ad ID."
    }
  },
  "additionalProperties": false
}

get_ad_lists

Read your saved lists, with ad creatives limited to advertisers you actively track. list_id selects one owned list; ad_id reports which of your lists contain that internal ad ID and takes precedence when both are supplied. Saving an ad does not bypass tracking limits.

read-only

Argument	Type	Description
ad_id	integer
list_id	integer

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "ad_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1
    },
    "list_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1
    }
  },
  "additionalProperties": false
}

get_advertiser_ads

Show one brand's active Meta ads (Facebook and Instagram). For brands AdSpendSpy tracks: active ad count, an estimated 30-day spend range split into EU/UK and US where available, and up to six top ads with image or video, headline, text, days running, platforms and landing domain. A brand name is matched exactly; if only similar names exist, it returns them as candidates and no ads. With live_lookup true, an untracked brand is looked up live in the Meta Ad Library (up to ten newest ads, no spend). No sign-in needed. Pass page_id when known, otherwise brand.

read-only

Argument	Type	Description
brand	string	Exact brand or advertiser name as the user wrote it, e.g. "Gymshark". Used only when no page_id is given; never matched to a differently named brand.
country	string	Two-letter ISO country code such as "DE", "US" or "GB" when the user names a country; "ALL" for worldwide.
page_id	string	Numeric Meta page ID of the advertiser, as returned in earlier results. Preferred when known.
live_lookup	boolean	True only after a previous call returned candidates and none is the brand the user means. Live lookups are limited per conversation and per day.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "brand": {
      "type": "string",
      "maxLength": 100,
      "minLength": 2,
      "description": "Exact brand or advertiser name as the user wrote it, e.g. \"Gymshark\". Used only when no page_id is given; never matched to a differently named brand."
    },
    "country": {
      "type": "string",
      "default": "ALL",
      "maxLength": 3,
      "minLength": 2,
      "description": "Two-letter ISO country code such as \"DE\", \"US\" or \"GB\" when the user names a country; \"ALL\" for worldwide."
    },
    "page_id": {
      "type": "string",
      "pattern": "^[0-9]+$",
      "maxLength": 25,
      "minLength": 3,
      "description": "Numeric Meta page ID of the advertiser, as returned in earlier results. Preferred when known."
    },
    "live_lookup": {
      "type": "boolean",
      "default": false,
      "description": "True only after a previous call returned candidates and none is the brand the user means. Live lookups are limited per conversation and per day."
    }
  },
  "additionalProperties": false
}

get_pending_alert_count

Read the number of pending alerts for your account.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {},
  "additionalProperties": false
}

get_projects

Read your projects. public_id selects one owned project; brand_id selects memberships for an actively tracked internal brand record and takes precedence when both are supplied.

read-only

Argument	Type	Description
brand_id	integer
public_id	string

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "brand_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1
    },
    "public_id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1
    }
  },
  "additionalProperties": false
}

get_top_ads_stats

Analyze latest cumulative estimated spend in EUR for your tracked advertisers. page_id is an exact advertiser filter. timeframe filters when ads were last seen, NOT spend accrued during that period. Creative breakdowns sample the top 1,000 ads; response metadata states matched and sampled counts and full-match aggregate spend. Zero can mean unavailable estimates.

read-only

Argument	Type	Description
q	string
page_id	string	Meta advertiser page ID, kept as a string.
project	string	all, my_brands, unassigned, or an owned project public_id. Every choice stays within your tracked brands.
category	string
timeframe	string	Last-seen window; never a period-spend calculation.
media_type	string
active_only	any

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 500
    },
    "page_id": {
      "type": "string",
      "pattern": "^[0-9]{5,25}$",
      "description": "Meta advertiser page ID, kept as a string."
    },
    "project": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "all, my_brands, unassigned, or an owned project public_id. Every choice stays within your tracked brands."
    },
    "category": {
      "type": "string",
      "maxLength": 100
    },
    "timeframe": {
      "enum": [
        "all",
        "7d",
        "30d",
        "90d"
      ],
      "type": "string",
      "default": "30d",
      "description": "Last-seen window; never a period-spend calculation."
    },
    "media_type": {
      "enum": [
        "all",
        "image",
        "video"
      ],
      "type": "string",
      "default": "all"
    },
    "active_only": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "enum": [
            "0",
            "1",
            "true",
            "false"
          ],
          "type": "string"
        }
      ],
      "default": false
    }
  },
  "additionalProperties": false
}

get_top_landingpages_stats

Rank the landing pages of your tracked advertisers by latest cumulative estimated spend in EUR. Ads are grouped by landing URL with ad, advertiser and active-ad counts, the top-spending advertiser and, when one is stored, a screenshot as screenshot_url (site path) and screenshot_full_url (absolute URL). page_id is an exact advertiser filter; q matches part of the landing URL. timeframe filters when ads were last seen, NOT spend accrued during that period. Zero can mean unavailable estimates.

read-only

Argument	Type	Description
q	string	Substring of the landing URL.
limit	integer
page_id	string	Meta advertiser page ID, kept as a string.
project	string	all, my_brands, unassigned, or an owned project public_id. Every choice stays within your tracked brands.
timeframe	string	Last-seen window; never a period-spend calculation.
active_only	any

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 500,
      "description": "Substring of the landing URL."
    },
    "limit": {
      "type": "integer",
      "default": 60,
      "maximum": 100,
      "minimum": 1
    },
    "page_id": {
      "type": "string",
      "pattern": "^[0-9]{5,25}$",
      "description": "Meta advertiser page ID, kept as a string."
    },
    "project": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "all, my_brands, unassigned, or an owned project public_id. Every choice stays within your tracked brands."
    },
    "timeframe": {
      "enum": [
        "all",
        "7d",
        "30d",
        "90d"
      ],
      "type": "string",
      "default": "30d",
      "description": "Last-seen window; never a period-spend calculation."
    },
    "active_only": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "enum": [
            "0",
            "1",
            "true",
            "false"
          ],
          "type": "string"
        }
      ],
      "default": false
    }
  },
  "additionalProperties": false
}

list_alerts

List spend alerts for ads of advertisers you actively track, newest first (event ad.spend_alert). Each item carries the alert threshold and the estimated spend when the alert was created. Without since_id or cursor the last 30 days are returned. since_id returns only items with a higher alert_id. Spend is a latest cumulative estimate in EUR; null means unknown. Reading alerts does not mark them as sent. Use page_id or project, not both.

read-only

Argument	Type	Description
limit	integer
cursor	string	Opaque pagination.next_cursor returned by the previous page with the same filters.
page_id	string	Meta advertiser page ID, kept as a string.
project	string	Public_id of one of your projects. Cannot be combined with page_id.
since_id	integer	Return only items with a higher id (internal_ad_id for new ads, alert_id for alerts).

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1
    },
    "cursor": {
      "type": "string",
      "maxLength": 1024,
      "minLength": 1,
      "description": "Opaque pagination.next_cursor returned by the previous page with the same filters."
    },
    "page_id": {
      "type": "string",
      "pattern": "^[0-9]{5,25}$",
      "description": "Meta advertiser page ID, kept as a string."
    },
    "project": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Public_id of one of your projects. Cannot be combined with page_id."
    },
    "since_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Return only items with a higher id (internal_ad_id for new ads, alert_id for alerts)."
    }
  },
  "additionalProperties": false
}

list_brand_ads

List creative summaries for one tracked advertiser, newest internal ID first, or with sort spend highest latest cumulative estimated spend first (use it for an advertiser's top ads). pagination.next_cursor returns the next page. Each ad carries internal_ad_id (AdSpendSpy ID) and meta_ad_id (the ad on Meta).

read-only

Argument	Type	Description
sort	string	newest = newest internal ID first; spend = highest estimated spend first.
limit	integer
cursor	string	Opaque pagination.next_cursor returned by the previous page with the same filters.
page_id*	string	Meta advertiser page ID, kept as a string.
media_type	string
active_only	boolean

Input schema (JSON)

{
  "type": "object",
  "required": [
    "page_id"
  ],
  "properties": {
    "sort": {
      "enum": [
        "newest",
        "spend"
      ],
      "type": "string",
      "default": "newest",
      "description": "newest = newest internal ID first; spend = highest estimated spend first."
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1
    },
    "cursor": {
      "type": "string",
      "maxLength": 512,
      "minLength": 1,
      "description": "Opaque pagination.next_cursor returned by the previous page with the same filters."
    },
    "page_id": {
      "type": "string",
      "pattern": "^[0-9]{5,25}$",
      "description": "Meta advertiser page ID, kept as a string."
    },
    "media_type": {
      "enum": [
        "all",
        "image",
        "video"
      ],
      "type": "string",
      "default": "all"
    },
    "active_only": {
      "type": "boolean",
      "default": false
    }
  },
  "additionalProperties": false
}

list_new_ads

List ads that newly appeared for advertisers you actively track, newest first (event ad.new). An ad counts as new when it started at most 7 days before it was first seen, so the back catalog of a freshly tracked advertiser is excluded. Without since_id or cursor the last 30 days are returned. since_id returns only items with a higher internal_ad_id. Spend is a latest cumulative estimate in EUR; null means unknown. Use page_id or project, not both.

read-only

Argument	Type	Description
limit	integer
cursor	string	Opaque pagination.next_cursor returned by the previous page with the same filters.
page_id	string	Meta advertiser page ID, kept as a string.
project	string	Public_id of one of your projects. Cannot be combined with page_id.
since_id	integer	Return only items with a higher id (internal_ad_id for new ads, alert_id for alerts).

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1
    },
    "cursor": {
      "type": "string",
      "maxLength": 1024,
      "minLength": 1,
      "description": "Opaque pagination.next_cursor returned by the previous page with the same filters."
    },
    "page_id": {
      "type": "string",
      "pattern": "^[0-9]{5,25}$",
      "description": "Meta advertiser page ID, kept as a string."
    },
    "project": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Public_id of one of your projects. Cannot be combined with page_id."
    },
    "since_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Return only items with a higher id (internal_ad_id for new ads, alert_id for alerts)."
    }
  },
  "additionalProperties": false
}

list_tracked_brands

List your actively tracked advertisers and their string page_id values.

read-only

Argument	Type	Description
project	string	all, my_brands, unassigned, or an owned project public_id. Every choice stays within your tracked brands.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "project": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "all, my_brands, unassigned, or an owned project public_id. Every choice stays within your tracked brands."
    }
  },
  "additionalProperties": false
}

search_advertisers

Search AdSpendSpy's Meta Ad Library database for an advertiser or brand by name. Returns up to five matching brands with category, logo, number of active ads where known, and the page_id. No sign-in needed.

read-only

Argument	Type	Description
query*	string	Brand or advertiser name, e.g. "Gymshark".

Input schema (JSON)

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 100,
      "minLength": 2,
      "description": "Brand or advertiser name, e.g. \"Gymshark\"."
    }
  },
  "additionalProperties": false
}

search_tracked_brands

Search your tracked advertisers by name, Meta page ID, or stored Facebook URL. Searches existing local data only; does not resolve vanity URLs through paid providers.

read-only

Argument	Type	Description
q*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1
    }
  },
  "additionalProperties": false
}

track_brand

Add a known advertiser to your tracked brands before reading its ads. Changes your AdSpendSpy account: the advertiser joins your tracked brands and AdSpendSpy starts importing its ads. Requires a Meta page_id and brand_name and consumes one of your existing account tracking slots, not an extra subscription. Repeating an active tracking is idempotent, even at the limit. New imports run in the background, so ads may not be ready yet. Returns tracked_count, tracked_limit, remaining_slots and ingestion_state. There is no MCP removal tool: remove brands on the AdSpendSpy website. Does not search Meta or resolve advertiser names or URLs.

destructive

Argument	Type	Description
page_id*	string	Meta advertiser page ID, kept as a string.
brand_name*	string	Advertiser display name, not a URL or an instruction.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "page_id",
    "brand_name"
  ],
  "properties": {
    "page_id": {
      "type": "string",
      "pattern": "^[0-9]{5,25}$",
      "description": "Meta advertiser page ID, kept as a string."
    },
    "brand_name": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Advertiser display name, not a URL or an instruction."
    }
  },
  "additionalProperties": false
}