SpyWinAds MCP server
Provides tools for looking up Facebook video ads, including when the video was first uploaded, ad dates, live ads, and stores running the same video.
Includes Instagram ads shown in the US within the SpyWinAds ad library data used by the server's ad lookup tools.
Uses Meta Ad Library links or ad IDs to retrieve video ad age, live ad status, and reuse across stores, based on Meta ads shown in the US.
Provides a tool to export Shopify product details such as title, prices, variants, and images, generate a Shopify-import CSV link, and surface the product's video ads in the library.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
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
AuthorizationheaderRead-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
Tool | Input | Returns |
| Meta Ad Library link or ad ID | When 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 |
| Store domain | Live ads, new ads in 7 days, videos, products, Pages, top videos with real age and store count |
| Facebook Page link or ID | Ads and live ads, videos, top videos, stores the Page sends traffic to |
| Shopify product URL | Title, prices, variants, images, a Shopify-import CSV link (24 hours), the product's video ads in the library |
| — | 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).
Related MCP server: Facebook Ad Library MCP
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 inCursor / 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
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Track competitors' Meta ads, save swipe files and run Meta campaigns from Claude, ChatGPT or Cursor.
Real-time Meta, Google, LinkedIn and TikTok ad library access for AI assistants. No API keys.
Facebook ads library with spend estimates and advertiser stats, plus Shopify product research.
Analyze, edit and launch Meta (Facebook and Instagram) ads from Claude, ChatGPT, Cursor or Codex. Query insights and campaign health, change budgets, bids, status and targeting with undo, bulk-launch many ads across campaigns and ad sets from a live ad's settings, and duplicate by post to keep social proof. Choose per ad account what the agent may do and what waits in the Agent Inbox for approval. Requires a paid Ads Uploader account with MCP access.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables searching and analyzing Facebook's public ads library for any brand, including ad images, text, and video analysis.823 npm332MIT
- AlicenseAqualityBmaintenanceGives AI agents read access to ads running across Meta platforms without an API key, returning full creatives, real landing URLs, and complete platform lists.9449 npm12MIT
- AlicenseNot gradedqualityCmaintenanceEnables searching and scraping the public Facebook Ad Library to extract structured ad data such as advertiser, copy, landing URLs, and CTAs for competitive research, all without an account or API token.MIT

Spytrend MCP Serverofficial
AlicenseNot gradedqualityBmaintenanceEnables AI assistants to search and retrieve Meta and TikTok advertising intelligence — ads, creatives, advertisers, the accounts behind them, destinations and rankings — through a hosted, browser-authenticated endpoint with no installation or API key. Supports full record lookups, similarity and trend queries, favorite folders, plus ready-made skills and recipes for competitive ad research.86MIT