SpyWinAds

com.spywinadsPublished by spywinads.comOfficial publisherv1.0.0Updated Oct 30, 2026

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

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingBusiness & Commerce

Overview

AI-generated overview

SpyWinAds is a hosted, read-only MCP server for Facebook video ad intel: a video's real upload age and the stores running the same video.

What you can do
  • Look up a Meta ad by Ad Library link or ad ID for the video's real age, first ad date, live ads and stores reusing it
  • Inspect a Shopify or online store's Facebook video ads, new ads in 7 days, products, Pages and top videos
  • Inspect a Facebook Page's ads, live ads, videos and the stores it sends traffic to
  • Read a public Shopify product page for title, prices, variants, images and a 24-hour CSV import link
  • Get headline numbers from the SpyWinAds Video Reuse Index with method links
When to use it
Useful for ecommerce and dropshipping research when you want to know whether a Facebook video ad is a new creative or an old video brought back, and how widely a video is reused across stores. Also handy for pulling a public Shopify product into a CSV for import.
Requirements
Remote Streamable HTTP endpoint; nothing to install. Sign in with a SpyWinAds account via OAuth 2.1, or send an API key in the Authorization header (from SpyWinAds Settings). Free plan allows 30 calls a day and 20 calls a minute; the research tool needs no sign-in.
Before you install
Requires a SpyWinAds account or API key; keep the key out of URLs and revoke it in Settings if exposed. Data covers US Meta ads only, counts are minimums of ads observed, and there is no spend, reach, orders or revenue data, so figures do not prove a product sells. The CSV export link expires after 24 hours.

Installation

In SourceWeft

  1. Open SpyWinAds in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.spywinads%2Fmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

[SpyWinAds]

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

bash
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)

json
{  "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.

[SpyWinAds consent screen]

Example prompts

REST API

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

bash
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

[email protected] · ATT ECOMMERCE COMPANY LIMITED, Hanoi, Vietnam

Source: README.md at commit 6f2c337

Tools

5

spywin_lookup_video_ad

Look up a Facebook 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. Returns the day the video file was first uploaded to Facebook (accurate to 1-2 days), the first ad date, live ads, how many stores run the same video now and ever, and the earliest stores in the SpyWinAds library.

Parametersadrequired

spywin_spy_store_ads

Spy on a store's Facebook 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.

Parametersdomainrequired

spywin_get_page_ads

Video ads of a Facebook Page

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.

Parameterspagerequired

spywin_export_shopify_product

Copy a Shopify product to CSV

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.

Parametersurlrequired

spywin_get_video_reuse_research

Video Reuse Index (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.

Takes no parameters.

Version history

1
  1. v1.0.0LatestOct 29, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.