# Connect Adspy to your AI assistant Adspy · Connect your AI · https://www.adspy.sh/connect · Updated Oct 26, 2026 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, 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 Unlimited: $19, $39 or $99 a month (chosen in the sign-in window if you have none) - First call: get_context, free [Connect your AI](https://www.adspy.sh/sign-up?next=/app) ## 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 connectors](https://claude.ai/customize/connectors) · [Claude help on custom connectors](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) ## 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](https://code.claude.com/docs/en/mcp#authenticate-from-the-command-line) ## 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](https://developers.openai.com/codex/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. Paid research is not part of the setup. ## ChatGPT and Cursor: coming soon Adspy has not yet been tested end to end in ChatGPT or Cursor. Both apps support remote MCP servers, and the Connect page of your Adspy console will show their steps once a full test passes. ## 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 . 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 credit balance and the connection's spending limits, so it proves the connection without paid 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 run paid research yet. ``` ## Ask your first questions Adspy answers research questions asked in plain words. Browsing ads and posts is included in your plan; your assistant asks before adding a new brand or account, and other paid results, such as a Brand Full Analysis (90 credits), say their price once. - "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." (90 credits) - "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) - "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." (120 credits) - "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) [Every Adspy tool, with its credit cost](https://www.adspy.sh/features/mcp#tools) ## Plans, credits and spending limits Adspy research needs a paid plan, Starter, Pro or Unlimited; without one, you choose it in the sign-in window, and Enterprise is set up on contract. Each connection gets a monthly spending limit for paid results when you approve it, which you can change or revoke in Settings. - **Starter:** $19 a month, one source (Meta, Google or TikTok), 2,000 credits included - **Pro:** $39 a month, every source (Meta, Google and TikTok), 6,000 credits included - **Unlimited:** $99 a month, every source, no credit count, fair use - **Enterprise:** On contract: the REST API with API keys, limits set in the contract, billed by invoice - **Credits:** Browsing is included on every plan, with fair use: ads, posts, their analysis and files of them. On Starter and Pro, credits pay for results: 90 for a Brand Full Analysis, 60 for a social report or each brand in a comparison, 400 to add a missing brand or a new social account. Credits belong to the team: everyone in the organization draws on the same monthly allowance, and an extra user adds no credits. [See pricing](https://www.adspy.sh/pricing) --- Ad research in your AI assistant: find ads, understand the creative, and keep your team's research together. Built in Rennes. For the research behind your next campaign. [Creative search](https://www.adspy.sh/features/creative-search) · [AI tags](https://www.adspy.sh/features/ai-tags) · [Brand fetch](https://www.adspy.sh/features/brand-fetch) · [Creative analysis](https://www.adspy.sh/features/creative-analysis) · [Brand Full Analysis](https://www.adspy.sh/features/brand-full-analysis) · [Brand X-Ray](https://www.adspy.sh/features/brand-x-ray) · [Social posts](https://www.adspy.sh/features/social-posts) · [Claude and Codex](https://www.adspy.sh/features/mcp) · [Competitor tracking](https://www.adspy.sh/features/competitor-tracking) · [Collections](https://www.adspy.sh/features/collections) · [Competitor strategy](https://www.adspy.sh/playbooks/competitor-ad-strategy) · [Lasting hooks](https://www.adspy.sh/playbooks/hooks-that-last) · [Brand comparison](https://www.adspy.sh/playbooks/compare-brands) · [Posts run as ads](https://www.adspy.sh/playbooks/posts-run-as-ads) · [All playbooks](https://www.adspy.sh/playbooks) · [Connect your AI](https://www.adspy.sh/connect) · [All features](https://www.adspy.sh/features) · [Pricing](https://www.adspy.sh/pricing) · [Good to know](https://www.adspy.sh/good-to-know) · [Comparisons](https://www.adspy.sh/compare) · [Spectrum](https://www.adspy.sh/ad-teardowns) · [Contact](mailto:info@adspy.sh) · [Legal notice](https://www.adspy.sh/legal) · [Terms of Sale and Service](https://www.adspy.sh/terms) · [Privacy](https://www.adspy.sh/privacy)