AdspySign inConnect your AI

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 your AISee pricing

Updated

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.

  1. In Claude, open Customize, then Connectors.
  2. Choose +, then Add custom connector.
  3. Name it Adspy, paste the server URL below and leave Advanced settings empty.
  4. Choose Connect, sign in to Adspy and approve the connection.
  5. In a conversation, turn Adspy on from the + menu if it is off.
Server URL
https://www.adspy.sh/mcp

Open Claude connectorsClaude help on custom connectors

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

  1. In ChatGPT on the web, open Plugins, choose Add, then Add custom MCP server.
  2. Name it Adspy, paste the server URL below under Connection and keep OAuth for authentication.
  3. Tick I understand and want to continue, then choose Create as a plugin.
  4. Sign in to Adspy and approve the connection.
  5. In a new chat, type @ and pick Adspy.
Server URL
https://www.adspy.sh/mcp

OpenAI help on custom MCP servers

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

Command
claude mcp add --transport http --scope user adspy 'https://www.adspy.sh/mcp' && claude mcp login adspy

Claude Code documentation on MCP

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

Command
codex mcp add adspy --url 'https://www.adspy.sh/mcp' && codex mcp login adspy

Codex documentation on MCP

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

  1. Ask which app the user wants Adspy in; never guess it from where the assistant is running.
  2. Configure only that app, and keep the user's other MCP servers as they are.
  3. 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.
  4. 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.

Ask your assistant
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 plan
  • Show 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 plan
  • Compare 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 plan
  • Which 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

Every Adspy tool, and what it counts

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.

See pricing

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.

https://www.adspy.sh/mcp
Connect your AI