Koskamo

SpyWinAds MCP

An official MCP server by SpyWinAds that allows AI assistants like ChatGPT and Claude to look up Facebook video ad data, including ad age and store usage, and export Shopify product data to CSV files.

Visit SpyWinAds

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

SpyWinAds MCP logo, by SpyWinAdsVendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-01Operated by SpyWinAds
You need:Free plan: 30 calls a dayOAuth sign-inEnter your email, and we'll send a confirmation link and show your key once.
MCP endpoint (Streamable HTTP)
https://spywinads.com/mcp
Vendor documentation

What you can do with it

  • Check if a Facebook video ad is new or reused
  • Find stores running specific Facebook video ads
  • Export Shopify product data to CSV for import
  • Get video reuse research figures

Source and maintenance

Vendor evidenceRegistry 1.0.0
mcp-registry: com.spywinads/mcp@1.0.0Source repositoryProject website
Maintenance checked

Protocol and capabilities

Server
spywinads 1.0.0
MCP protocol
2025-06-18
Tools
5 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": false
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

SpyWinAds checks Facebook video ads for online sellers: a video's real age (when the file was first uploaded to Meta) and every store running the same video. US Meta ads only. Read-only. Data: 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. These numbers do not show whether a product sells or makes a profit: many live or new ads can mean heavy testing, and a video run by many stores is copied, not proven. 'Earliest store' means earliest in the library, not the owner.

Tools

5 advertised

spywin_lookup_video_ad — Look up a Facebook video ad
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

spywin_lookup_video_ad input schema
{
  "type": "object",
  "required": [
    "ad"
  ],
  "properties": {
    "ad": {
      "type": "string",
      "description": "Meta Ad Library link (https://www.facebook.com/ads/library/?id=...) or the numeric ad ID"
    }
  }
}
spywin_lookup_video_ad annotations
{
  "title": "Look up a Facebook video ad",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
spywin_spy_store_ads — Spy on a store's Facebook ads
Advertised by the server during the last successful anonymous check.
Advertised read-only

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_spy_store_ads input schema
{
  "type": "object",
  "required": [
    "domain"
  ],
  "properties": {
    "domain": {
      "type": "string",
      "description": "Store domain, e.g. example.com"
    }
  }
}
spywin_spy_store_ads annotations
{
  "title": "Spy on a store's Facebook ads",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
spywin_get_page_ads — Video ads of a Facebook Page
Advertised by the server during the last successful anonymous check.
Advertised read-only

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_page_ads input schema
{
  "type": "object",
  "required": [
    "page"
  ],
  "properties": {
    "page": {
      "type": "string",
      "description": "Facebook Page link (https://www.facebook.com/...) or numeric Page ID"
    }
  }
}
spywin_get_page_ads annotations
{
  "title": "Video ads of a Facebook Page",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
spywin_export_shopify_product — Copy a Shopify product to CSV
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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_export_shopify_product input schema
{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Product URL, e.g. https://store.com/products/handle"
    }
  }
}
spywin_export_shopify_product annotations
{
  "title": "Copy a Shopify product to CSV",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
spywin_get_video_reuse_research — Video Reuse Index (research)
Advertised by the server during the last successful anonymous check.
Advertised read-only

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_video_reuse_research input schema
{
  "type": "object",
  "properties": {}
}
spywin_get_video_reuse_research annotations
{
  "title": "Video Reuse Index (research)",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
1142 ms
95th percentile latency
1142 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 1142 ms · metadata changed · 5 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http spywinads-mcp https://spywinads.com/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add spywinads-mcp --url https://spywinads.com/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable spywinads-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "spywinads-mcp": {
      "url": "https://spywinads.com/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "spywinads-mcp": {
      "type": "streamableHttp",
      "url": "https://spywinads.com/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start spywinads-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "spywinads-mcp": {
      "type": "http",
      "url": "https://spywinads.com/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http spywinads-mcp https://spywinads.com/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.
Claude Desktop configuration
{
  "mcpServers": {
    "spywinads-mcp": {
      "url": "https://spywinads.com/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "spywinads-mcp": {
      "serverUrl": "https://spywinads.com/mcp"
    }
  }
}

Let your agent find its tools

Find servers like SpyWinAds MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 4,713

Do you run SpyWinAds MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing