Connect Adspy to your AI assistant
Adspy (adspy.sh) is an MCP server for researching public Meta and Google ads and brands' TikTok, YouTube and Instagram posts. Connect it once to Claude, ChatGPT, Claude Code, Codex or another MCP client, sign in to Adspy in the browser, then ask about any brand's ads in plain words.
- Server URL
- https://www.adspy.sh/mcp
- Transport
- Streamable HTTP
- Sign-in
- OAuth 2.1 in the browser, or an API key
- Plans
- Starter, Pro or Scale: $19, $39 or $99 a monthchosen in the sign-in window if you have none
- First call
- get_context, free
Connect Adspy to Claude
Claude adds Adspy as a custom connector in its settings; a prompt cannot add it for you. Once added on claude.ai, the connector also works in the Claude desktop and mobile apps.
- In Claude, open Customize, then Connectors.
- Choose +, then Add custom connector.
- Name it Adspy, paste the server URL below and leave Advanced settings empty.
- Choose Connect, sign in to Adspy and approve the connection.
- In a conversation, turn Adspy on from the + menu if it is off.
https://www.adspy.sh/mcpConnect Adspy to ChatGPT
ChatGPT adds Adspy as a custom MCP plugin, from Plugins on the web; a prompt cannot add it for you. OpenAI opens custom MCP servers to Business and Enterprise workspaces, where admins and owners add them, and to Pro, with read tools only. Adspy's answers then open as views in the chat, as in Claude.
- In ChatGPT on the web, open Plugins, choose Add, then Add custom MCP server.
- Name it Adspy, paste the server URL below under Connection and keep OAuth for authentication.
- Tick I understand and want to continue, then choose Create as a plugin.
- Sign in to Adspy and approve the connection.
- In a new chat, type @ and pick Adspy.
https://www.adspy.sh/mcpConnect Adspy to Claude Code
Claude Code adds Adspy with one command, then opens the browser so you can sign in to Adspy and approve the connection. Run the command in a terminal, or paste the setup prompt from your Adspy console and let Claude Code run it for you.
claude mcp add --transport http --scope user adspy 'https://www.adspy.sh/mcp' && claude mcp login adspyConnect Adspy to Codex
Codex adds Adspy with one command, then opens the browser so you can sign in to Adspy and approve the connection. Run the command in a terminal, or paste the setup prompt from your Adspy console and let Codex run it for you.
codex mcp add adspy --url 'https://www.adspy.sh/mcp' && codex mcp login adspyLet an assistant set Adspy up
An AI assistant that runs commands, such as Claude Code or Codex, can set Adspy up for you. The setup prompt in your Adspy console asks it to follow these four rules, and the Markdown version of this page gives an assistant the same rules.
- Ask which app the user wants Adspy in; never guess it from where the assistant is running.
- Configure only that app, and keep the user's other MCP servers as they are.
- Let the user sign in to Adspy and approve the connection in the browser. Never ask for an API key, a token or a password in the chat.
- Call the free get_context tool, and say Adspy is connected only after it answers. Research is not part of the setup.
Connect another MCP client
Any client that supports remote MCP servers over Streamable HTTP can connect to Adspy. Sign-in uses OAuth 2.1 in the browser; a client without OAuth sends an Adspy API key, created in Settings, as a Bearer token.
- Server URL
- https://www.adspy.sh/mcp
- Transport
- Streamable HTTP
- OAuth
- OAuth 2.1 with PKCE (S256), client ID metadata documents or dynamic client registration; the discovery documents are under /.well-known.
- API key
- Send Authorization: Bearer <ADSPY_API_KEY>. Keep the key in an environment variable, never in a chat.
Check the connection with get_context
Adspy's get_context tool is free. It returns your workspace, your plan and what the plan has used, so it proves the connection without starting any research. Treat Adspy as connected only after get_context answers.
What can I do with Adspy? Check my connection with get_context first. Do not start any research yet.Ask your first questions
Adspy answers research questions asked in plain words. What you ask for is included in your plan: ads and posts, reports such as a Brand Full Analysis, comparisons and exports. Your assistant asks before adding a new brand or account, which counts toward your plan's new brands.
Run a Brand Full Analysis of AG1 over the last 90 days. Tell me which formats, hooks and landing pages it leans on, which ads it has kept running the longest, and what changed in the last month.
Included in every planShow me Ritual's video ads that have been running for at least 30 days, longest first, and break down how each one opens in its first seconds.
Included in every planCompare the ads of AG1 and Huel over the last 90 days: formats, hooks, offers and how long each keeps its ads running. Then tell me where they differ most.
Included in every planWhich of AG1's TikTok, YouTube or Instagram posts were later run as ads? Show each post next to its ad, with the delay between them.
Included in every plan
Plans and what they count
Adspy research needs a paid plan, Starter, Pro or Scale; without one, you choose it in the sign-in window, and Enterprise is set up on contract. A plan counts two things: the brands it follows, and the new brands or social accounts it adds to Adspy each month. You can revoke a connection in Settings at any time.
- Starter
- $19 a month, one source (Meta, Google or TikTok), 5 followed brands and 5 new brands a month
- Pro
- $39 a month, every source (Meta, Google and TikTok), 15 followed brands and 15 new brands a month
- Scale
- $99 a month, every source, 100 followed brands and 50 new brands a month, with the followed-brands report
- Enterprise
- On contract: the REST API with API keys, limits set in the contract, billed by invoice
- Included
- Every plan includes the research itself, with fair use: searching and opening ads with their AI analysis, similar ads, collections, a brand's organic posts with their AI tags, posts run as ads, files of them, Brand X-Rays, Brand Full Analyses, social reports and comparisons.
- New brand
- A new brand is one Adspy does not hold yet: adding it collects its ads, or a social account's posts. A brand already in Adspy never counts.
- At a limit
- At a limit nothing is charged: Adspy says the limit, the date it resets and the plan that includes more, and brands already in Adspy stay open.
Have a brand in mind?
Add Adspy to your assistant with this URL, sign in, and ask about its ads. You need no ad account.