SpyWinAds MCP Server

by spywinads Your server? Claim it

answering

SpyWinAds is answering right now. Last checked 8 min ago. It exposes 15 tools. Last commit 29 Oct 2026.

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

Uptime history 11 days of history · worst day 98%

11 days agonow

98.9%

Uptime 24h

90 of 91 checks

Tools

read from the server

776 ms

Response time

average over 24h

Stars

last commit 29 Oct 2026

What changed 12

Every tool that appeared, vanished or quietly changed what it asks for. Recorded since 6 November 2026. No other catalogue keeps this.

6 Nov 10 tools appeared spywin_get_my_overview, spywin_get_my_scanner_status, spywin_get_scan_results and 7 more

6 Nov a tool description was rewritten spywin_lookup_video_ad

6 Nov a tool changed the parameters it asks for spywin_lookup_video_ad

SpyWinAds does not always answer

Over the last week it answered 99.1% of our checks. We check every 15 minutes, so you hear about the next outage within the hour — not from your users.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 8 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

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

Settings → Connectors → Add custom connector, then paste this address

https://spywinads.com/mcp

~/.codex/config.toml

[mcp_servers.mcp]
url = "https://spywinads.com/mcp"

.cursor/mcp.json

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

.vscode/mcp.json

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

Available tools 15

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

spywin

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_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_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 only run while the app is open on the user's computer.

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_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_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). Includes the app status. When a keyword scan is done, read the videos with spywin_get_scan_results; when a Page / store / ad scan is done, call its lookup tool again.

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_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_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_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_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 ad date, landing page. Max 50 per call.

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 (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.

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 app is closed, not installed, or Facebook is pausing the home network, nothing is queued and the status says so (app_off, no_app, fb_paused) with the next step. Returns a scan_id for spywin_get_scan_status and spywin_get_scan_results.

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). Uses the plan's daily competitor-research limit. If the app is closed, not installed, or Facebook is pausing the home network, nothing is queued and the status says so. Returns a request_id for spywin_get_scan_status; when done, call the lookup tool again.

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.

Endpoints

URL	Transport	State	Latency	Checked
https://spywinads.com/mcp	streamable-http	answering	702 ms	8 min ago

Alternatives to SpyWinAds

same job, measured the same way

Projectlaunch

by projectlaunch

Agent-facing site in pre-launch; agents can read the site and submit intent.

4 tools answering

Ourpr MCP Server

by joeyaflores

Read your own ourpr running history in an AI agent, and put a plan on the week ahead.

63 installs/wk local only

AdSwipeFile

by adswipefile

Winning Facebook and Instagram ads, competitor ads, hooks and angles for your AI agent. Read-only.

answering

Winning Ads Finder: Facebook Ad Library Scorer

by nero-engine

Scores Meta Ad Library scraper rows by days running and copies to find proven winning ads

answering

Backup Radar MCP

by servosity

Every Backup Radar v3 and v2 endpoint plus a local store that finds the backups nobody is watching.

local only

cliphou.se release videos

by cliphou

Turns every release into a social video. Finds the selling points, picks the angle, writes the copy.

6 tools answering

deploy.social

by deploy

Post a video once to YouTube Shorts, Instagram/Facebook Reels, TikTok, Threads, X and Bluesky

answering

Playhead

by tryplayhead

Watches a video or ad from a link and answers in words, with the second of every moment.

answering

SpyWinAds — questions

Answers built from our own checks of this server.

What can SpyWinAds do?

It exposes 15 tools, read directly from the server on our last check. Among them: spywin_export_shopify_product, spywin_get_my_overview, spywin_get_my_scanner_status, spywin_get_page_ads, spywin_get_scan_results, spywin_get_scan_status and 9 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

Is SpyWinAds working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 90 of 91 checks got a reply (98.9%), average response time 776 ms. The bar chart above shows every period we have measured.

How do I connect SpyWinAds?

Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does SpyWinAds need an API key?

No. SpyWinAds completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 15 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is SpyWinAds?

It answers our handshake in 776 ms on average, which is faster than 11% of all working MCP servers we measure. That is on the slow side — worth knowing if the tool sits inside an interactive loop. The comparison comes from our own checks across the whole registry, every 15 minutes.

Is SpyWinAds open source?

We cannot say either way: 0 stars on GitHub, but we could not determine the licence, and without one the code is not open source by default.