Adspy

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

The MCP server built only for ads.

Adspy · https://www.adspy.sh/ · Updated Nov 9, 2026

Adspy is an MCP server. Add one URL to your assistant, then ask in plain words. The ads and the numbers open in your chat.

Server URL: https://www.adspy.sh/mcp · How to connect

Works in: Claude, Claude Code, Codex. Coming soon: ChatGPT, Cursor.

You, in Claude: Show me BMW's image ads, and how each was made.

BMW (Automotive, on Meta). Creative search, BMW, Image ads:

• 3D render, recorded may 2026
• Branded production, recorded may 2026
• 3D render, recorded may 2026

Three of BMW's image ads, tagged 3D render and branded production. Want me to read one?

You, in Claude: Run a Brand Full Analysis of HexClad.

HexClad (Home and Living, on Meta). Brand Full Analysis, as of Nov 11, 2026:

• 5,280 creatives recorded
• 4,935 analysed by Adspy
• 378 new in the last 30 days
• 1,282 new in the last 90 days
• New creatives per month, Dec 2025 to Nov 2026. The busiest was Oct 2026, with 571.
• 52% images, 48% videos
• Most common video opening: Bold statement, 20%

You, in Claude: Take apart this Sephora ad.

Sephora (Beauty and Personal Care, on Meta). Creative analysis, video ad, first frame:

• Opens with: Visual surprise
• AI tags: Branded production, Product closeup
• First recorded: Jun 30, 2025
• Source: Meta
• Format: Video
• Ads using it: 20

Sephora in the library

• 2.5K+ brands tracked
• 7.5M+ ads indexed
• 2.2M+ unique creatives
• $19 a month to start

Show me MINI's image ads, and how each was made.

You, in Claude. Searches the library: Included.

MINI (Automotive, on Meta). Creative search, 3 shown. Read as: MINI, Image ads.

• Branded production, Meta, image, First recorded Jan 1, 2025, Used in 3 ads
• Branded production, Meta, image, First recorded Oct 1, 2024, Used in 13 ads
• Branded production, Meta, image, First recorded Oct 1, 2024, Used in 14 ads

Three of MINI's image ads, tagged branded production. Want me to read one?

MINI in the library

Show me Ffern's image ads, and how each was made.

Ffern (Beauty and Personal Care, on Meta). Creative search, 3 shown. Read as: Ffern, Image ads.

• Studio shot, Meta, image, First recorded Nov 28, 2025, Used in 32 ads
• Studio shot, Meta, image, First recorded Jun 27, 2025, Used in 24 ads
• Studio shot, Meta, image, First recorded May 14, 2026, Used in 2 ads

Three of Ffern's image ads, tagged studio shot. Want me to read one?

Ffern in the library

Show me Revolut's image ads, and how each was made.

Revolut (Finance and Fintech, on Meta). Creative search, 3 shown. Read as: Revolut, Image ads.

• Branded production, Meta, image, First recorded Jun 17, 2024, Used in 32 ads
• Branded production, Meta, image, First recorded Oct 30, 2023, Used in 22 ads
• Product photography, Meta, image, First recorded Jun 30, 2024, Used in 30 ads

Three of Revolut's image ads, tagged branded production and product photography. Want me to read one?

Revolut in the library

The answer opens in your chat.

1. Ask in plain words. Name a brand and say what you want to see.
2. Adspy searches the library. Browsing ads and their AI analyses is included: it costs no credits.
3. The answer is a view. Claude shows it in the chat. Claude Code and Codex get the same answer as text and files.

Find

By brand, by format, or by what an ad shows. Pick a filter and the others step back.

You, in Claude: Show me image ads.

Searches the library: Included.

Filter the ads: Travel and Hospitality (7), Automotive (4), Real Estate (2), Branded production (7), Product photography (4), Studio shot (2).

• ALL - Accor Live Limitless: Travel and Hospitality, Branded production
• Apple: Technology and Software, Product photography
• Expedia: Travel and Hospitality, UGC
• Porsche: Automotive, Studio shot
• Ffern: Beauty and Personal Care, Studio shot
• Uber Eats: Food and Beverage, Product photography
• Hilton: Travel and Hospitality, Branded production
• Iberia: Travel and Hospitality, Stock footage
• DAMAC Properties: Real Estate, Branded production
• Porsche: Automotive, Branded production
• Galeries Lafayette: Fashion and Apparel, Product photography
• Airbnb: Travel and Hospitality, Lifestyle photography
• MINI: Automotive, 3D render
• DAMAC Properties: Real Estate, Branded production
• Royal Caribbean International: Travel and Hospitality, Stock footage
• Revolut: Finance and Fintech, Product photography
• Porsche: Automotive, Branded production
• TUI: Travel and Hospitality, Branded production

18 ads from 15 brand pages of the library.

Read

Every ad comes with its public record, pinned to the ad itself, and the reading Adspy stored for it.

You, in Claude: Take apart this AG1 ad.

Reads its AI analysis: Included.

• Brand: AG1
• Source: Meta Ad Library
• Format: Video
• First recorded: Mar 27, 2026
• Used in: 52 ads

Hook

Bold statement (0-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. The text overlay 'High performers don't skip the fundamentals' immediately establishes a aspirational and performance-oriented tone. The visual is clean, minimalist, and focused on the product.

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.

The ad effectively leverages clear visuals, concise messaging, and a strong offer to drive immediate conversions.

AI tags

• Hook tactic: Bold claim
• Messaging angle: Benefit-led
• Asset type: Branded production
• Talent type: Hands only

Transcript

1. High performers don't skip the fundamentals
2. AG1
3. Daily Foundational Nutrition Supplement
4. With Vitamins, Minerals, Probiotics and Prebiotics.
5. One AG1 Travel Pack
6. Energy, digestion & immune support
7. AG1
8. At home or on-the-go
9. Try AG1 today

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

Analyze

One request reads a brand's ads and posts together. Every figure comes with its count.

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

Brand Full Analysis, last 90 days: 90 credits.

AG1 · Brand Full Analysis. Read from the library on 26 October 2026.

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

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

Compare

You, in Claude: Compare AG1 with Huel.

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

Observed public ads per brand: not spend, reach or performance. Read from the library on 26 October 2026.

AG1

• 2,523 ads observed over 90 days
• Leading format: Video, 55%

Huel

• 740 ads observed over 90 days
• Leading format: Image, 61%

Keep

Save the ads worth a second look. Your team opens the same collection.

You, in Claude: Save these five to “Q4 hooks” with a note on each, follow Porsche, and export the collection to Excel.

Saves 5 ads: Free. Follows the brand: Free. Exports to Excel: Included.

Q4 hooks: 5 ads, shared with the team.

• Collection: Q4 hooks, 5 ads · 5 notes. Saved in your workspace: your team picks it up from their own assistant.
• Follow: Porsche, following. Ask for the newest ads from the brands you follow.
• Export: Excel (.xlsx). Ready · link kept 7 days. Also CSV, JSON, ZIP with media, Markdown, HTML; PDF for reports and comparisons.

2,000 brands. Free to read.

One page per brand in the ad library. No account needed.

• Apple (Technology and Software)
• BMW (Automotive)
• Expedia (Travel and Hospitality)
• Netflix (Entertainment and Media)
• Porsche (Automotive)
• Sephora (Beauty and Personal Care)

New brand

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

Looks the brand up: Free.

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

• Where: Found on Meta Ad Library or Google Ads Transparency
• Price: 400 credits, asked first
• Time: 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.

Everything your assistant can do.

Adspy gives your assistant 43 research tools. 34 of them are free or included: browsing ads, posts and their AI analyses costs nothing. The followed-brands report comes with Unlimited and Enterprise, and a paid result says its price before it runs.

Start

4 tools, all free or included.

• 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

5 tools, all free or included.

• 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)
• search_creatives_by_meaning: Finds ads whose transcript says an idea you describe, even in other words. (Included)
• find_similar_creatives: Finds other brands' ads that share specific AI tags. (Included)

Read

10 tools, 3 cost credits.

• 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)
• list_creative_tags: Lists the AI tag vocabulary by category, for exact tag filters. (Free)
• count_creatives: Counts the ads matching a phrase, per search field. (Free)
• find_brand_by_domain: Finds the brands whose ads land on a domain. (Free)
• find_same_media: Lists every brand holding the exact same image or video. (Free)
• get_brand_freshness: Says when a brand's newest ad was seen and when its data was last collected. (Free)

Fetch

2 tools, 1 costs credits.

• 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

7 tools, 3 cost credits.

• 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

11 tools, all free or included.

• 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)
• unfollow_brand: Stops following a brand in the workspace. (Free)
• list_followed_brands: Lists the brands the workspace follows. (Free)
• get_followed_brands_report: What changed at the followed brands over the last day, 7 days or 30 days. (Included with Unlimited and Enterprise)
• remove_creatives: Takes ads out of a collection. (Free)
• update_collection: Renames a collection or changes its description. (Free)
• delete_collection: Deletes a collection and its notes; the ads stay in the library. (Free)

Export

4 tools, 1 costs credits.

• export_research: Exports ads, social posts and post-ad pairs to CSV, Excel, JSON or a ZIP of media, ads also to Markdown or HTML; reports and comparisons to PDF, Excel, JSON or CSV. (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.

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

Finds posts run as ads: Included.

• Meta: Facebook and Instagram ads, and Instagram posts.

• Google: Google and YouTube ads, and YouTube posts.

• TikTok: TikTok posts; TikTok ads are not covered.

• Meta ad: Huel

• Google ad: Garmin

• TikTok post: AG1

• YouTube post: AG1

• Instagram post: Gymshark

27 TikTok posts later ran as ads

Median 7.3 days from post to ad.

• TikTok post, @drinkag1, Published Mar 15, 2026, 2,251 views
• Meta ad, AG1, First recorded Apr 8, 2026

Same image, 23.5 days later. The post came first; the ad reused its image. Paid reach stays apart from the organic numbers.

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

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 ads that say your idea (Find creative ideas, Included): "Find ads that talk about trouble sleeping at night, even if they word it differently."
• 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

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.

1. Add the URL. Paste it as a connector in your assistant.
2. Sign in. The trial runs 3 days with 100 credits. You need no ad account.
3. Ask about a brand. Name it and say what you want to see. The answer opens as a view in the chat.

Claude

Views in the chat. Claude.ai, 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

Claude Code

Text and files. Terminal and IDE extensions.

1. Run this command once in your terminal.
2. A browser window opens: sign in to Adspy and approve the connection.
3. Claude Code 2.1.186 or later signs in from the command line.

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

Codex

Text and files. CLI and IDE extension.

1. Run this command once in your terminal.
2. A browser window opens: sign in to Adspy and approve the connection.

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

Other

With the URL. Any remote MCP client.

1. Add a remote MCP server named adspy with this URL (Streamable HTTP, OAuth).
2. A browser window opens: sign in to Adspy and approve the connection.
3. A client without OAuth uses an API key instead.

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

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

Claude, Claude Code and Codex today. ChatGPT and Cursor are coming soon. Full setup guide

Four plans, all in your AI assistant.

Starter: $19 a month

• 2,000 credits a month
• One source: Meta, Google or TikTok
• Extra users, $5 a month each

Start the trial

Pro: $39 a month

• 6,000 credits a month
• Every source
• Extra users, $15 a month each

Start the trial

Unlimited: $99 a month

• No credit count, fair use
• Every source
• Extra users, $29 a month each

Start the trial

Enterprise: On quote

• Everything in Unlimited
• REST API under a contract

Talk to us

What 2,000 and 6,000 credits buy.

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, and they belong to the whole team.

• Brand Full Analysis: 90 credits. A brand's ads, organic posts and how they connect, per brand and range. Free again for 24 hours.
• Social report, Brand X-Ray or a compared brand: 60 credits. A brand's social report asked alone, a Brand X-Ray, or each brand in a comparison. Free again for 24 hours.
• New brand or social account: 400 credits. Adding a brand the library lacks, or collecting an account Adspy does not collect yet. Your assistant asks first; an account Adspy already collects costs 0.
• Browsing: Included. Ads and their AI analysis, posts and their AI tags, similar ads, posts run as ads, collections and exports.

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) and 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. Spend, conversions, and ROAS stay in the advertiser's own account.

Is there a free plan or trial?

There is no free plan, but your first subscription starts with a 3-day free trial with 100 credits, card required. Then 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, sign in, and ask about its ads.

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