Prototype · Preview: every server in the official registry, synced every 30 minutes. Reviews and accounts come in a later step.
PopNx MCPMCP servers for people who use AI · explained in plain words

SpyWinAds

by anhnguyendjversion 1.0.0i★ –iRuns in the cloud
Registry namecom.spywinads/mcp

Install

Overview

Description from the maker (original English)

Facebook video ad intel: a video ad's real age and every store running the same video.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

  • Connection: Runs in the cloud
  • Transport: Streamable HTTP
  • Category: Marketing & social media

Install

Pick the AI app you use, then copy the settings.

Before you install

  • Basic checks: 3 of 3 passed
  • Runs on the maker’s server: what you ask it goes through their server.
  • Can do 15 things (tools) spywin_lookup_video_ad, spywin_spy_store_ads, spywin_get_page_ads, spywin_export_shopify_product …
  • The registry lists no key to fill in.

You need

Which app do you use?

Pick your app above. We remember it, so next time the button says “Install in …”.

Works in Claude on the web, desktop and mobile:

  1. Open Settings → Connectors
  2. Press Add custom connector
  3. Paste the address below and press Add
  4. If it asks you to sign in, sign in with the maker
SettingsConnectors1+ Add2https://…3
https://spywinads.com/mcp

Run this in your terminal

claude mcp add --transport http spywinads https://spywinads.com/mcp

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "spywinads": {
      "url": "https://spywinads.com/mcp"
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "spywinads": {
      "type": "http",
      "url": "https://spywinads.com/mcp"
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

ChatGPT connects only to servers on the internet:

  1. Open ChatGPT on the web → Settings → Connectors (Apps)
  2. Press Create or Add (some plans need Developer mode under Advanced first)
  3. Paste the address below, give it a name and save
  4. If it asks you to sign in, sign in with the maker
SettingsConnectors1+ Create2https://…3
https://spywinads.com/mcp

Menu names can differ slightly by plan and over time.

Your choice stays on this device in a cookie; no account needed.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Tool names and descriptions exactly as the server reported them on Nov 7, 2026. The maker wrote them, not us; we show them as plain text.

  • spywin_lookup_video_ad

    Check how old a Facebook video ad really is and which stores run the same video. Input: a Meta Ad Library link or ad ID, or a SpyWinAds video_id (from spywin_list_my_videos, spywin_get_scan_results or other tools). Returns the day the video file was first uploaded to Facebook (ac

  • spywin_spy_store_ads

    See the Facebook video ads a Shopify / online store is running. Input: the store domain. Returns live ads, new ads in 7 days, number of videos, products and Pages, and the top videos with their real age and how many stores run each one.

  • spywin_get_page_ads

    See the video ads a Facebook Page runs: total and live ads, videos, top videos with real age, and the stores the Page sends traffic to. Input: Facebook Page link or Page ID.

  • spywin_export_shopify_product

    Read a public Shopify product page and return its title, prices, variants and images, plus a download link to a Shopify-import CSV (valid 24 hours) and the product's video ads if the SpyWinAds library has them.

  • spywin_get_video_reuse_research

    Headline numbers from SpyWinAds Research 'Video Reuse Index': how often Facebook video ads are old videos brought back, how many stores share a video, and how fast a video spreads to 5 stores. With method link.

  • spywin_get_my_scanner_status

    Status of the SpyWinAds desktop app on the user's computer: no_app (not installed / not paired), app_off (not seen for 5+ minutes), fb_paused (Facebook temporarily limited the home network, with the time scanning resumes), scanning or idle, plus jobs running and waiting. Scans on

  • spywin_get_my_overview

    Counts for the signed-in user's SpyWinAds account: videos in each tab (Win, potential, scale, cash-cow, followed, testing, waiting for deep dig), videos found in the last 30 days, stores, and the latest keyword scan.

  • spywin_list_my_videos

    List the videos in one tab of the user's SpyWinAds account (only videos the user's own app found). Each video: product line from the ad, the day the video file first appeared on Facebook (or first ad if unknown), age in days, live ads, total ads seen, stores running it now, first

  • spywin_list_my_scans

    The user's keyword scans in the last 30 days, newest first: scan id, start time (Vietnam time), first keyword, number of keywords, still running or done. Use the scan id with spywin_get_scan_results.

  • spywin_get_scan_results

    Videos one of the user's keyword scans found (50 per page, strongest first): same fields as spywin_list_my_videos plus the keyword and the tab the video is in, if any.

  • spywin_list_my_stores

    Stores running videos from the user's tabs: domain, platform, Pages, which tabs, ads seen, when the store was last scanned and new videos found then.

  • spywin_get_video_history

    Night-by-night history (up to 30 days) of one video in the user's account: Pages running it (live), stores running it (live), Win / scale / old ad counts, total ads, landing pages, and what changed from the night before.

  • spywin_queue_keyword_scan

    Start Facebook Ad Library keyword scans on the user's own SpyWinAds desktop app (it scans from the user's home network). Up to 10 keywords per call, 30 new keywords a day. Keywords someone scanned fully in the last 24 hours return at once from the library (status cached). If the

  • spywin_queue_page_scan

    When spywin_get_page_ads, spywin_spy_store_ads or spywin_lookup_video_ad say the library does not have it yet, ask the user's own SpyWinAds desktop app to scan it from the user's home network. kind: page (Facebook Page link or ID), store (domain), ad (Ad Library link or ad ID). U

  • spywin_get_scan_status

    Progress of a keyword scan (scan_id from spywin_queue_keyword_scan / spywin_list_my_scans: per keyword queued, running, done, failed or expired — not picked up by the app within 15 minutes — and ads found) or of a Page / store / ad scan (request_id from spywin_queue_page_scan). I

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified against the domain spywinads.com (the registry checks domain ownership)

  • … Not checked yet

    Still maintained

    We have not read this repo from GitHub yet

  • … Not checked yet

    Has a licence

    We have not read this repo from GitHub yet

  • ✓ Pass

    Endpoint responds

    Responded in 525 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 15 tool descriptions and found no hidden instructions to the AI

Compared with others in Marketing & social mediai

  • More stars than 0% of the other 2985 servers in this category
  • Published to the registry more recently than 80% of the other 2985 servers in this category
  • Basic checks equal to or better than 100% of the other 2985 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is SpyWinAds safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.

Is it still maintained?

The GitHub repo last changed –, and the latest version (1.0.0) reached the registry 9 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.

What can I use instead?

In the same category: MCP YouTube Transcript, Google Analytics MCP, BibiGPT YouTube Video Summarizer

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

An MCP server retrieving transcripts of YouTube videos

Runs on your computer★ 495MITUpdated 10 days ago
Install

GA4 MCP server for AI agents: schema discovery, server-side aggregation, analysis-ready defaults.

Runs on your computer★ 244MITUpdated 10 days ago
Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

SpyWinAds MCP server

Check Facebook video ads from ChatGPT, Claude, Cursor or your own scripts: how old a video ad really is, and every store running the same video.

  • Remote server: https://spywinads.com/mcp (Streamable HTTP)
  • Auth: OAuth 2.1 (sign in with your SpyWinAds account), or an API key in the Authorization header
  • Read-only. 5 tools. Free plan: 30 calls a day.
  • Docs: spywinads.com/developers

This repository only documents the hosted server. There is nothing to install.

Tools

ToolInputReturns
spywin_lookup_video_adMeta Ad Library link or ad IDWhen the video file was first uploaded to Facebook (within 1–2 days), first ad date, live ads, stores running the same video now and ever, earliest stores in the library
spywin_spy_store_adsStore domainLive ads, new ads in 7 days, videos, products, Pages, top videos with real age and store count
spywin_get_page_adsFacebook Page link or IDAds and live ads, videos, top videos, stores the Page sends traffic to
spywin_export_shopify_productShopify product URLTitle, prices, variants, images, a Shopify-import CSV link (24 hours), the product's video ads in the library
spywin_get_video_reuse_research—Headline numbers of the SpyWinAds Video Reuse Index, with method and data links. No sign-in needed

All tools are annotated readOnlyHint: true, destructiveHint: false. Scopes: ads:read (look-ups) and product:export (CSV).

Connect

ChatGPT — open Plugins in the left sidebar → More (top right) → Add custom MCP server → paste https://spywinads.com/mcp. When a tool needs your account, ChatGPT asks you to sign in to SpyWinAds and click Allow.

Claude.ai / Claude Desktop — Customize → Connectors → Add custom connector → paste https://spywinads.com/mcp → choose Sign in when needed.

Claude Code

claude mcp add --transport http spywinads https://spywinads.com/mcp

then run /mcp inside Claude Code to sign in

Cursor / VS Code / Windsurf (API key from SpyWinAds Settings → API & MCP)

{

"mcpServers": { "spywinads": { "url": "https://spywinads.com/mcp", "headers": { "Authorization": "Bearer YOUR_KEY" } } } }

Never put a key in a URL. Keys and connected apps can be revoked any time in SpyWinAds Settings → API & MCP.

Example prompts

  • "Is this video ad new or an old video brought back? https://www.facebook.com/ads/library/?id=1014622548199238"
  • "What Facebook video ads is zenblux.com running, and how many other stores use the same videos?"
  • "Copy this Shopify product into a CSV I can import: https://www.allbirds.com/products/mens-tree-runners"

REST API

Same tools over HTTPS for scripts, n8n and GPT Actions:

curl -H "Authorization: Bearer YOUR_KEY" "https://spywinads.com/api/v1/store?domain=example.com"

Endpoints: /api/v1/video?ad= · /api/v1/store?domain= · /api/v1/page?page= · /api/v1/product?url= · /api/v1/research/video-reuse. OpenAPI: https://spywinads.com/api/v1/openapi.json. Errors are application/problem+json (RFC 9457); limits come back in RateLimit / Retry-After headers.

Data and limits

  • Meta (Facebook, Instagram) ads shown in the US, from the SpyWinAds library (ads scanned by SpyWinAds users).
  • Counts are minimums of ads observed, not sales. No ad spend, reach, orders or revenue data.
  • "Earliest store" means earliest in the library, not the verified owner of the video.
  • Each call returns what the free SpyWinAds web tools show; there is no search across the whole library.
  • Limits: free 30 calls a day (resets 00:00 UTC+7), 20 calls a minute.

Security and privacy

  • OAuth 2.1 with PKCE (S256), protected resource metadata (RFC 9728) at /.well-known/oauth-protected-resource/mcp, authorization server metadata (RFC 8414), dynamic client registration and client ID metadata documents. Access tokens last 1 hour; refresh tokens rotate.
  • Tokens and keys are stored only as SHA-256 hashes. Tokens are bound to https://spywinads.com/mcp.
  • We log the tool name, success or error and the calling app, not your prompts. Privacy policy: spywinads.com/privacy.

Support

support@spywinads.com · ATT ECOMMERCE COMPANY LIMITED, Hanoi, Vietnam

Ask PopNx