US EN
Black Friday Banco BRB
● Active
Mobile
USA
BLACK FRIDAY IESA BYD
● Active
Mobile
USA
Croma - Black Friday 🛒🛍️
● Active
Mobile
USA
Black Friday - up to 70% off
● Active
Mobile
USA
Cyber Week: last chance
● Active
Mobile
USA
Black Friday deals inside 🛍️
● Active
Mobile
USA

Spy.house & MCP

Millions of competitor ads, queryable in plain language. Pull them into Claude, ChatGPT, Cursor, VS Code or Codex.
Connect your client

Connector URL

Your MCP connector URL
Paste this URL into your MCP client.
How to connect

Connect in just 3 steps

1
Add the server
Point your MCP client at the endpoint above — one line of config, or a command below.
2
Sign in with Spy.House
Your client opens a browser to authorize via OAuth. You sign in with your Spy.House account — no API key. An active paid subscription is required; trial cannot connect.
3
Ask your agent
“Find up to 12 Black Friday FB creatives for the USA”. The agent calls the right tool and answers.
Connection

Pick your client

CLI clients (Claude Code, Codex): after adding the server, restart the client — a running session will not load it. Then sign in: Claude Code with /mcp, Codex with the `codex mcp login` line in the command below.
Claude
Claude
Desktop and web use the Client ID below. Claude Code uses the CLI command, which has its own Client ID.

Desktop / web: Settings → Connectors → Add custom connector

Paste the endpoint URL and the Client ID below, then Connect & authorize.

claude mcp add --transport http --client-id spy-mcp-claude-code \
--callback-port 8787 spy-house https://spy.house/mcp
Client ID: spy-mcp-claude-desktop
Codex
Codex
Add the remote server with one command, then sign in.
codex mcp add spy-house --url https://spy.house/mcp \
--oauth-client-id spy-mcp-codex
codex mcp login spy-house
Client ID: spy-mcp-codex
Cursor
Cursor
Run the command, or add the server to ~/.cursor/mcp.json or .cursor/mcp.json.
cursor --add-mcp '{"name":"spy-house","url":"https://spy.house/mcp","auth":{"CLIENT_ID":"spy-mcp-cursor","scopes":["mcp:search"]}}'
Client ID: spy-mcp-cursor
VS Code
VS Code
Run the command, or add the server to user or workspace mcp.json.
code --add-mcp '{"name":"spy-house","type":"http","url":"https://spy.house/mcp","oauth":{"clientId":"spy-mcp-vscode"}}'
Client ID: spy-mcp-vscode
Claude Web
Claude Web
  1. Open Claude → Customize → Connectors → Add custom connector.
  2. Specify: Name — Spy.House, URL — https://spy.house/mcp. In Advanced OAuth settings, specify Client ID spy-mcp-claude-desktop; leave Client Secret blank.
  3. Click Add / Connect.
ChatGPT
ChatGPT
  1. In ChatGPT web enable Settings → Security and login → Developer mode, then add a remote MCP app in Plugins: URL https://spy.house/mcp, Client ID spy-mcp-chatgpt, Streamable HTTP, no Client Secret.
  2. Click Connect / Authenticate, log in to Spy.House, and confirm access. An API key and Client Secret are not required.
  3. Run this query: > Find up to 12 Black Friday FB creatives for the US.

Verification by request

After connecting, run these queries in your client. The expected results are a checklist, not a live search.

search_creatives
Verification request
Find up to 12 Black Friday Facebook ad creatives for the US.
Expected result:
Up to 12 creatives, including data and remaining search quota. One network per call: push, inpage, facebook, tiktok or native. Each non-empty search consumes one unit of the quota.
get_filter_options
Verification request
List the available Facebook search filters.
Expected result:
The non-adult Facebook filter catalog and exact values for search_creatives. Adult filters are omitted.
get_creative_media
Verification request
Show me the images of the creatives you just found.
Expected result:
Media for up to three creative_ref from that search. Search quota is not charged. Full video is not returned, and the chat may not render an inline preview.
render_creatives_gallery
Verification request
Show these creatives as a gallery.
Expected result:
An embedded gallery of 1–12 creative_ref from the same search, in clients that support MCP Apps. Other clients skip this tool and use text or get_creative_media.
In case of an error, please send: the client AI name, the time, the error text, and a screenshot.

Frequently asked questions

How do I connect Spy.House MCP to Claude, ChatGPT, Cursor, VS Code or Codex?
MCP is included with an active paid subscription and is not available on trial. Open https://spy.house/mcp-integration, copy the connector URL and follow the steps for your client. After adding a CLI server, restart the client and sign in with Spy.House.
Remove or disable the Spy.House server in the AI client. Access also stops when the paid subscription ends. Trial accounts cannot connect.

Email: [email protected]

Telegram: https://telegram.me/Spy_House

Support hours: Mon–Fri, 10:00–18:00 (UTC+3)