Adspy

npx add-mcp 'https://www.adspy.sh/mcp'

Ask your AI about any brand's ads.

Adspy · MCP server for ad research · https://www.adspy.sh/ · Updated Oct 26, 2026

Connect Adspy to Claude, Claude Code or Codex, then ask about any brand's Meta and Google ads and its TikTok, YouTube and Instagram posts. In Claude, each answer opens as a view in the chat.

• Works in: Claude, Claude Code, Codex
• Sources: Meta, Google, TikTok
• MCP tools: 31

Connect your AI · Server URL: https://www.adspy.sh/mcp

Real ads from the library, redrawn: Typology, The Ordinary, CeraVe Skincare, 23 Mai Paris, Nespresso, Cometeer, Chamberlain Coffee, Grind, Our Place, Tediber, IKEA, HexClad.

Ask. The answer opens in your chat.

One session in Claude with Adspy connected, on AG1. Every ad, figure and line below was read from the library on Oct 26, 2026; the ads are redrawn in pixel art.

Find

You: Show me AG1's video ads that ran 30 days or more, longest first.

Adspy: Searches the library · Included

AG1 by Athletic Greens · 6 video ads (Ran 30 days or more · longest first):

• 282 days · Ended · 1 ad
• 282 days · Ended · 2 ads
• 226 days · Ended · 2 ads
• 203 days · Live · 44 ads
• 191 days · Live · 31 ads
• 190 days · Live · 52 ads

Your assistant: The longest ran for months. One of them runs under 52 ads: want me to read it?

Read

You: Take apart the one running under 52 ads.

Adspy: Reads its AI analysis · Included

• Hook: Bold statement · 0 to 5 seconds. The video opens with a close-up of a branded AG1 travel pack being held horizontally above a clear bottle filled with water and ice.
• Key message: AG1 is a fundamental nutrition supplement for high performers that supports energy, digestion, and immunity, and is currently available with a special spring offer.
• AI tags: Hook tactic Bold claim; Messaging angle Benefit-led; Asset type Branded production; Talent type Hands only
• 52 ads use this creative · 190 days recorded

Your assistant: That is the reading stored for this ad. A Brand Full Analysis would show the patterns across the brand, for 90 credits.

Analyze

You: Run a Brand Full Analysis of AG1 over the last 90 days.

Adspy: Brand Full Analysis, last 90 days · 90 credits

AG1 by Athletic Greens · Brand Full Analysis:

• New ads per week: 1.5× faster (1,090 in the last 30 days vs 1,433 in the 60 before)
• Posts that later ran as ads: 18% (16 of 88 posts · likely between 11% and 28%)
• From post to ad: 6.4 days (median of 16 posts · likely between 3.5 and 12.4 days)
• Format mix of new ads: 55% video (of 2,523 ads first seen in the last 90 days)

Each figure with its count · free again for 24 hours

Your assistant: Four figures from its ads and posts, each with its count. I can compare it with a competitor, 60 credits per brand.

Compare

You: Compare AG1 with Huel.

Adspy: Compares 2 brands, last 90 days · up to 120 credits

Brand	Ads observed	Active	Median days running	Main format
AG1 by Athletic Greens	2,523	2,442	33 days	video, 55%
Huel	740	543	30 days	image, 61%

Observed public ads per brand: not spend, reach or performance.

Your assistant: Side by side from their public ads. Want to see which of AG1's posts became ads?

Social

You: Which of AG1's TikTok posts later ran as ads?

Adspy: Finds posts run as ads · Included

• 27 TikTok posts later ran as ads, median 7.3 days from post to ad.
• TikTok post by @drinkag1 (Mar 15, 2026), then the Meta ad first seen Apr 8, 2026: Same image, 23.5 days later.

Your assistant: The post came first; the ad reused its image. Paid reach stays apart from the organic numbers.

Add a brand

You: If a brand isn't in Adspy yet, can you add it?

Adspy: Looks the brand up · Free

• New brand: Found on Meta Ad Library or Google Ads Transparency.
• 400 credits, asked first.
• Median 2.3 minutes · 94% within 10 minutes, measured on 663 collections.
• The card follows the collection and shows its 20 newest ads when it is done.

Your assistant: Yes. I look it up first, for free, and ask you before the collection starts.

Keep

You: Save the three that ran longest to “Q4 hooks” with a note on each, follow AG1, and export the collection to Excel.

Adspy: Saves 3 ads · Free Adspy: Follows the brand · Free Adspy: Exports to Excel · Included

• Q4 hooks: 3 ads · 3 notes
• AG1 by Athletic Greens: Following. Ask for the newest ads from the brands you follow.
• Excel (.xlsx): Ready · link kept 7 days. Also CSV, JSON, ZIP with media, Markdown, HTML; PDF for reports and comparisons.

Your assistant: Saved in your workspace: your team picks it up from their own assistant.

Works where you already ask.

Claude shows Adspy's answers as views in the chat. Claude Code and Codex get the same answers as text and files. Any remote MCP client connects with the URL, and a client without OAuth uses an API key.

• Claude (Claude.ai, desktop and mobile apps): Views in the chat
• Claude Code (Terminal and IDE extensions): Text and files
• ChatGPT (Developer mode apps): Coming soon
• Codex (CLI and IDE extension): Text and files
• Cursor (Agent chat in the editor): Coming soon
• Other (Any remote MCP client): With the URL

Add the server

Paste the URL in Claude's connectors, or run one command in Claude Code or Codex.

Server URL: https://www.adspy.sh/mcp

Claude Code:

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

Codex:

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

Sign in and pick a plan

A browser window opens: sign in to Adspy, choose a plan if you have none, and approve the connection.

Ask your first question

The connection check is free and opens the welcome card.

What can I do with Adspy? Check my connection with get_context first. Do not run paid research yet.

Full setup guide

Everything your assistant can do.

Adspy gives your assistant 31 tools. 23 of them are free or included: browsing ads, posts and their AI analyses costs nothing. A paid result says its price before it runs.

Start

• get_context: Checks the connection: workspace, permissions, credit balance and limits. (Free)
• list_playbooks: Shows ready research jobs by goal, each with its steps, its price and a prompt to run. (Free)
• quote_operation: Returns the most a paid call can cost before it runs. (Free)
• get_usage: Shows the organization's balance and receipts. (Free)

Find

• search_brands: Finds brands in the library by name. (Free)
• search_advertisers: Looks a brand up in Meta Ad Library and Google Ads Transparency. (Free)
• search_creatives: Searches ads with scopes, filters, AI tags and a sort order. (Included)
• find_similar_creatives: Finds other brands' ads that share specific AI tags. (Included)

Read

• get_creatives: Returns creatives with their source ads and existing transcripts. (Included)
• get_creative_analysis: Returns an ad's stored AI reading; an ad without one says so. (Included)
• get_brand_xray: Runs Brand X-Ray for one brand and range; reused free for 24 hours. (60 credits)
• get_brand_full_analysis: Reads one brand's ads, organic posts and how they connect, each finding with its sample size and 95% interval; reused free for 24 hours, with the brand's social report. (90 credits)
• compare_brands: Compares two to five brands on the same range. (Up to 60 credits per brand)

Fetch

• request_brand_fetch: Adds a missing Meta or Google advertiser to the library once you say yes; its 20 newest ads come with it. (400 credits, new requests only)
• get_fetch_job: Reads a fetch's stage and the ads or posts processed. (Free)

Social posts

• search_social_accounts: Finds a brand's TikTok, YouTube or Instagram account. (Free)
• request_social_fetch: Collects the organic posts of a TikTok, YouTube or Instagram account once you say yes; its 20 latest come with it. (400 credits, 0 for an account Adspy already collects)
• list_social_posts: Lists a brand's organic posts by date, engagement or breakouts, with paid reach apart. (Included)
• get_social_posts: Reads posts in detail: snapshots, the ads that reused them and AI tags. (Included)
• find_posts_run_as_ads: Pairs a brand's organic posts with the ads that reused them. (Included)
• get_brand_social: Reports a brand's engagement, cadence, formats, breakouts and paid reach. (60 credits, reused for 24 hours)
• compare_social: Compares two to five brands' organic posts with verdicts and their sample sizes. (Up to 60 credits per brand)

Keep

• list_collections: Lists the workspace's collections. (Free)
• get_collection: Reads a collection's saved ads and notes. (Included)
• save_creatives: Saves ads to a collection, or creates one by name. (Free)
• update_note: Writes the note on a saved ad. (Free)
• follow_brand: Follows a brand in the workspace. (Free)

Export

• export_research: Exports ads, social posts, post-ad pairs, reports and comparisons to CSV, Excel, JSON or a ZIP of media; ads also to Markdown or HTML, reports and comparisons to PDF. (Included; a report not read in 24 hours, 60 credits per brand)
• get_job: Reads an export's progress and its download link. (Free)
• list_exports: Lists your exports from the last 7 days. (Free)
• renew_delivery_links: Renews media links from an earlier result; links last 21 days. (Free)

Every tool in detail

Three sources. The ads, and the posts behind them.

Meta, Google and TikTok, read the same way: the public ads, the brands' organic posts, and the posts that later ran as ads.

• Meta: Facebook and Instagram ads, and Instagram posts.
• Google: Google and YouTube ads, and YouTube posts.
• TikTok: TikTok posts; TikTok ads are not covered.

Examples from the library: Huel (Meta ad), Garmin (Google ad), AG1 (TikTok post), AG1 (YouTube post), Gymshark (Instagram post).

• No spend, ROAS, reach or targeting: they stay in each advertiser's account.
• TikTok ads are not covered, only TikTok posts.
• Instagram posts come from professional accounts, through Meta's official API.

Library records · October 2026: 2.2M+ creative records, 7.5M+ source-ad records, 2.5k+ advertiser profiles, 3 sources: Meta, Google, TikTok.

Start from a playbook

Ready prompts for the research people ask Adspy for most. Paste one into your assistant, change the brand, and read the answer in the chat.

• Read a competitor's ad strategy (Study a competitor, 90 credits): "Run a Brand Full Analysis of AG1 over the last 90 days."
• Find hooks that keep running (Find creative ideas, Included): "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."
• Compare brands side by side (Study a competitor, 120 credits): "Compare the ads of AG1 and Huel over the last 90 days: formats, hooks, offers and how long each keeps its ads running."
• Spot the posts a brand ran as ads (Read organic social, Included): "Which of AG1's TikTok, YouTube or Instagram posts were later run as ads?"

All playbooks

Four plans, all in your AI assistant.

On every plan you research through MCP in Claude, Claude Code or Codex, with browsing included. Starter covers one source with 2,000 credits a month, Pro every source with 6,000, Unlimited every source with no credit count, and Enterprise adds the REST API under a contract.

Starter: $19

$19 per month · one user included. One source: Meta, Google or TikTok. 2,000 credits a month. Up to 22 Brand Full Analyses, 33 social reports or 5 new brands or accounts.

• Research in Claude, Claude Code and Codex
• Browsing included: ads, posts, AI analyses and AI tags
• Shared collections, notes and followed brands
• +$5 per extra user a month

Choose Starter

Pro: $39

$39 per month · one user included. Every source: Meta, Google and TikTok. 6,000 credits a month. Up to 66 Brand Full Analyses, 100 social reports or 15 new brands or accounts.

• Everything in Starter
• Meta and Google ads, and TikTok, YouTube and Instagram posts
• Brands compared across every source
• +$15 per extra user a month

Choose Pro

Unlimited: $99

$99 per month · one user included. Every source: Meta, Google and TikTok. No credit count, fair use. Results cost no credits; browsing and new brands follow fair use.

• Everything in Pro
• No credit count on any result
• Fair use on browsing and new collections
• +$29 per extra user a month

Choose Unlimited

Enterprise: Custom

Custom on contract · invoice billing. Every source: Meta, Google and TikTok. Limits set in your contract. No credits: users, API calls and new collections are agreed with you.

• Everything in Unlimited, within your contract
• REST API with API keys, Instagram excluded
• Fetches, follows, collections and exports by API
• Billed by invoice

Contact us

Research together: +$5 on Starter, +$15 on Pro, +$29 on Unlimited, per extra user a month

Starter, Pro and Unlimited include one user, and Enterprise sets its users in the contract. Credits belong to the team: everyone in the organization draws on the same monthly allowance, and an extra user adds no credits.

Compare every plan

Good to know

What is an MCP server?

MCP, the Model Context Protocol, is the open standard that lets an AI assistant use outside tools. Adspy's MCP server gives your assistant tools to search ads and posts, read their analysis and keep your research; you connect it once with its URL, www.adspy.sh/mcp.

Which AI assistants work with Adspy?

Claude (claude.ai, desktop and mobile apps), Claude Code (terminal and ide extensions), Codex (cli and ide extension) are tested end to end; in Claude, answers open as views in the chat. Any client that supports remote MCP servers over Streamable HTTP can connect, with OAuth or an Adspy API key. ChatGPT and Cursor are coming soon.

Do I need to code?

No. In Claude you paste the server URL in Connectors. In Claude Code or Codex you run one command, or ask the assistant to run it for you. Then you ask in plain words, and the assistant picks the tools.

What does Adspy see of my conversations?

Only what your assistant sends to Adspy's tools, such as a brand name or a search, and the results Adspy returns. The rest of the conversation stays between you and your assistant, whose provider's own terms apply.

Do I need to connect an ad account?

No. Adspy reads public ads from Meta and Google and brands' public TikTok, YouTube and Instagram posts. You connect your AI assistant to Adspy, never your own advertising accounts.

Which platforms are covered?

Meta covers Facebook and Instagram. Google data comes from its Ads Transparency Center and includes available YouTube creatives. Each ad shows its source and the details available for that creative. Adspy also collects the organic posts of brands' TikTok, YouTube and Instagram accounts; TikTok ads are not covered. Starter includes one source of your choice (Meta, Google or TikTok); Pro, Unlimited and Enterprise include all three.

How fresh is the data?

It depends on the brand and the source. Each ad carries the dates Adspy first and last recorded it, so your assistant can tell you how recent a finding is.

Can I research brands from different countries?

Yes. The library includes brands from multiple markets. Coverage depends on what the public source makes available and what has been collected, so it can vary from one brand to another.

Do you show competitor spend or ROAS?

No. Adspy shows observed public advertising, including creatives, recorded activity, and available analysis. Running time can be useful context, but it does not tell you whether an ad is profitable. Spend, conversions, and ROAS stay in the advertiser's own account.

Is there a free plan or trial?

No. Adspy has no free plan or trial. Starter $19, Pro $39 and Unlimited $99 a month, and Enterprise is on contract; you can cancel anytime, and paid access continues until the end of the billing period.

How do additional users work?

Starter, Pro and Unlimited include one user. An extra user is $5 a month on Starter, $15 on Pro and $29 on Unlimited; Enterprise sets users in the contract. Credits belong to the team: everyone in the organization draws on the same monthly allowance, and an extra user adds no credits. Manage the number of users in Billing, then invite people from Team. Reductions take effect at renewal.

What does research cost?

Browsing is included on every plan, 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, and files of them cost no credits. Credits pay for results only. A Brand Full Analysis costs 90 credits per brand and range; it reopens free for 24 hours, and so does the brand's social report. A social report asked alone, a Brand X-Ray, or each brand in a comparison, costs 60. Adding a brand the library lacks, or collecting a new social account, costs 400. Starter includes 2,000 credits a month and Pro 6,000; Unlimited has no credit count (fair use), and Enterprise sets its limits in the contract. On Starter and Pro, reading past fair use costs 1 credit per new item until the limit resets; on Unlimited, new items wait for the reset. Your assistant asks before adding a new brand or account.

Can I keep research together with my team?

Yes. Ask your assistant to save ads into collections and add notes in a shared workspace. Teammates with access to that workspace can pick up the research from their own assistant without searching for the same ads again. Additional paid users are billed with your organization's plan.

Can I stop whenever I want?

Yes. Manage or cancel your subscription from Billing. If you cancel, paid access continues until the end of the billing period. Your saved research is kept for when you come back.

Have a brand in mind?

Add Adspy to your assistant with this URL, sign in, and ask about its ads. Connecting takes a few minutes, and no ad account.

Connect your AI · Server URL: https://www.adspy.sh/mcp

---

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 · AI tags · Brand fetch · Creative analysis · Brand Full Analysis · Brand X-Ray · Social posts · Claude and Codex · Competitor tracking · Collections · Competitor strategy · Lasting hooks · Brand comparison · Posts run as ads · All playbooks · Connect your AI · All features · Pricing · Good to know · Comparisons · Spectrum · Contact · Legal notice · Terms of Sale and Service · Privacy