How to give ChatGPT or Claude access to real Facebook ad examples

The four ways to give an assistant real ad examples

1. Paste screenshots and copy. Free, manual, works in every assistant. You are the connector.
2. Meta Ad Library API plus your own code. Free from Meta, but limited to certain ads and it needs a developer setup.
3. A third-party MCP server that lists ad data. The assistant searches and reads ads on its own. Most are paid; a few have a free allowance.
4. AdSwipeFile's MCP server. A library of 63,244+ winning Facebook and Instagram ads, read-only, free to connect.

One more thing is easily mixed up with these: connectors that bring your own ad account into an assistant. They show your results, not other brands' ads. This guide covers competitor and example ads.

Option 1: paste screenshots and copy (free)

The simplest method needs no account and no setup.

1. Find the ad in the Meta Ad Library or your own feed.
2. Take a screenshot of the creative, or a screen recording for video.
3. Paste the primary text and headline as text, because assistants read text more reliably than text inside an image.
4. Add what the image cannot show: the start date, the number of ads sharing the creative, the landing page and your tags.
5. Paste three to six ads in one message and ask a narrow question.

A prompt that works: "These are four competitor ads for [product]. For each, give the hook, the angle and the format, then list what they share. Do not guess results, you only have the creatives."

Its limits are the work and the size. Every ad is a copy-paste job, an assistant can only read as many as fit in a chat, and nothing is saved for next time. It suits a one-off question, not a weekly habit.

Option 2: the Meta Ad Library API and your own code

Meta publishes an Ad Library API. It is the official route to ad data in code, and what it returns is narrower than the website.

• What it covers: Ad Library API: political and issue ads worldwide and ads delivered in the EU or UK, plus active public branded content for authorized users; needs an identity check and a developer app.
• Who gets it: Meta limits the Ad Library API to authorized users, who can also analyze active public branded content on Facebook and Instagram, and its Ad Targeting dataset (targeting detail for social issue, electoral and political ads, kept 7 years) to approved researchers.
• What it will not give you: ordinary commercial ads from outside the EU and UK, and any spend or sales for them. Spend and reach ranges for political ads; reach and targeting detail for EU ads; a separate Ad Targeting dataset for approved researchers.

To use it with an assistant you would confirm your identity with Meta, create a developer app, write code that calls the ads_archive endpoint, and then either paste the results into a chat or wrap the code in your own MCP server. That is a real project, and it suits a developer researching political or EU ads. For product ads in the US, it is the wrong source. More in the Meta Ad Library API guide and the Meta Ad Library limits.

Is there an MCP server for the Meta Ad Library?

From Meta itself: None from Meta that we found, as of 24 October 2026. What exists are third-party MCP servers that list ad data, some reading Meta's public library live and some searching a database they built. The table lists the tools whose own sites say they have one.

How they differ in practice:

• SpreshApp (Spresh) is a research layer on the live Facebook Ad Library: AI search by audience, a daily feed on competitor brands (Brand Spy), saved ads, and an API and MCP server on every plan.
• AdLibrarySpy is a free Shopify store and Meta ads research tool: a store index with SimilarWeb traffic, a Meta ad library ranked in Meta's own impressions order, a Brandtracker, a weekly report, a Chrome extension and an MCP server.
• Klipio is AI ad intelligence and ad generation: it models your brand from your website, watches the competitors you pick in Meta's public Ad Library, mines their winning angles and turns them into on-brand ads you can push to Meta. New accounts are on a waitlist.
• AdPlexity Social is a Meta ad spy tool for performance marketers that follows each ad past the click: landing pages, redirect chains, tech stack and affiliate offers, with an MCP server and API on its one plan. Native, push, desktop, mobile and adult ads are separate AdPlexity products.

For the full list with an MCP column, see the Meta Ad Library MCP servers compared and the best ad spy tools.

How to choose an MCP server for ad examples

Ask these before you connect one:

1. Is it read-only? For research you want read access. A server with write access to your ad accounts is a different tool with different risks.
2. What are you spending per question? Many count one credit or call per ad read, so a question that reads thirty ads costs thirty.
3. Does the library keep ads after they stop? A live reader shows what runs today; a library shows what ran.
4. How does it sign in? OAuth with your account is easier to revoke than a key pasted into a config file.
5. Does it cover Facebook and Instagram? Several cover TikTok or Google as well. That is useful only if you advertise there.

Your priority, then the pick:

• A free allowance to try: AdLibrarySpy (Yes, free, 1,000 calls/day) or AdSwipeFile's free plan.
• Meta's live public library: Spresh or Klipio.
• Detail past the click (landing pages, redirects, affiliate offers): AdPlexity.
• Your own ad accounts as well: Atria or Motion.

Set up AdSwipeFile in your assistant

AdSwipeFile runs one remote MCP server for every assistant. The address is https://adswipefile.com/api/mcp. It uses OAuth 2.1, so you sign in with your AdSwipeFile account (email link or code, or Google) and approve read access once. There is no API key. Connecting is free on every plan, and a free account is enough.

• Claude: open Settings, then Connectors, then Add custom connector. Name it AdSwipeFile, paste the server URL and click Add. Click Connect, sign in and approve.
• ChatGPT: open Settings, then Apps and Connectors, then Advanced settings and turn on Developer mode. Back in Apps and Connectors, click Create, paste the server URL and choose OAuth. Sign in and approve.
• Claude Code: run claude mcp add --transport http adswipefile https://adswipefile.com/api/mcp, then run /mcp in Claude Code and sign in.
• Cursor: add the URL under mcpServers in ~/.cursor/mcp.json, then sign in when Cursor prompts you.
• Codex: run codex mcp add adswipefile --url https://adswipefile.com/api/mcp, then codex mcp login adswipefile.

Gemini CLI, Hermes and OpenClaw are in the MCP docs. Per-assistant pages with prompts: Claude, ChatGPT, Cursor.

What the AdSwipeFile tools return

Eleven read-only tools. The ones you will use:

• search_library: keyword search across ads, brands, niches and formats. Start here with a product or an idea.
• list_ads: browse ads, newest first, filtered by brand, niche, format, visual format, hook tactic, season and offer type. sort: "longest_running" puts the ads tracked longest on Meta first.
• get_ad and get_ads: one ad, or up to ten, in full: copy, brand, niche, tags, image and page links, run dates when the ad is tracked on Meta, and a note on how the ad is built.
• list_brands, list_niches, list_formats, list_visual_formats, list_hooks: the names and slugs the filters take.
• list_saved_ads and list_followed_ads: your saves with their notes and boards, and the newest ads from the brands you follow.

Ask for a niche, a format or a brand, such as Beauty, Fashion, Fitness and wellness, Food and drink, Pets, Home and garden, Apps and software, Jewelry and watches, UGC selfie, Review, Before and after, Product image, Unboxing, Listicle, Text overlay, Us vs them or AG1, Glossier, Liquid Death, Warby Parker, or browse them yourself under niches, formats and brands. Your AI agent gets the same filters through the tools. Every ad comes with its page link. A long run is a reason to study an ad, never a result: the tools carry no spend or conversion data, and the assistant is told not to state any.

Example prompts to copy

• "Show me winning UGC ads in skincare. For each, give the brand, the hook, the angle and the link."
• "What ads is Glossier running? Sum up the formats and hooks it repeats."
• "Find 8 longest-running ads in pet food, read the three closest to a subscription box and write five hooks in their styles."
• "Map the ads of [brand A], [brand B] and [brand C] in a table. Which angles does none of them run?"
• "What did the brands I follow launch this week?"

Allowance, ad copy and limits

• Free: 50 MCP/API calls for the life of the account, and the first 50 ads of every list with their copy. Listing the niches, formats, visual formats and hooks is free of the allowance.
• Pro: $39 a month, after a 7-day trial: 10,000 MCP/API calls a month and every ad of every list, on the site and in your assistant.
• How calls count. get_ads counts one per ad it reads, so a question that reads ten ads costs ten. On a paid plan a list_ads or search_library page counts one per ten ads asked for.
• Read-only. The tools cannot change your saves, run ads or touch any ad account.

What it is not: a live feed of the Meta Ad Library, a source of spend or performance data, or a tool that generates images or video. It holds Facebook and Instagram ads only. Write about what the library holds, not what is running right now.

Try AdSwipeFile with your assistant

Copy the setup prompt and paste it into Claude, ChatGPT or Cursor. It connects the library and asks for recent ads from your niche. Free: 50 MCP/API calls for the life of the account and the first 50 ads of every list, no card.

Copy setup promptCopied

Continue with Google

Setup steps for each assistant

FAQ

How do I give ChatGPT or Claude access to real Facebook ad examples?

Paste screenshots and copy for a one-off, or connect an MCP server that lists ads. AdSwipeFile's runs at https://adswipefile.com/api/mcp: add it as a connector in Claude or ChatGPT and sign in with a free account.

Is there an MCP server for the Meta Ad Library I can use in Claude?

None from Meta that we found. Third-party servers exist, such as Spresh, Klipio, AdLibrarySpy and AdSwipeFile. See the table above, and the full comparison page.

Does ChatGPT have access to the Facebook Ad Library?

Not on its own. It can read screenshots you paste, or ads from an MCP server you connect, such as AdSwipeFile's.

Can Claude read ads from the Meta Ad Library API?

Only through code you write or a tool that does it for you. The API covers political and issue ads worldwide and ads delivered in the EU or UK, so it will not return ordinary product ads in the US.

Is AdSwipeFile's MCP server free?

Connecting is free on every plan. A free account gets 50 MCP/API calls for the life of the account and the first 50 ads of every list, with their copy; Pro at $39 a month adds every ad and 10,000 MCP/API calls a month.

Can the AI see how much an ad spent or whether it worked?

No. The Meta Ad Library does not publish spend for ordinary product ads, and AdSwipeFile holds no performance data. The assistant can tell you how an ad is built and how long it ran, not whether it paid.

Is it safe to connect an MCP server to Claude or ChatGPT?

Connect only servers you trust, and prefer read-only ones with OAuth sign-in. AdSwipeFile's tools are read-only and you approve read access when you sign in.

Sources

Checked on 6 November 2026 and 12 November 2026 on each tool's own site. Prices are in US dollars as listed, and change: check the source before you buy. AdSwipeFile's facts come from its pricing page.

1. Meta Ad Library
2. Meta Ad Library API
3. Meta Ad Library tools
4. Graph API ads_archive reference
5. Swipekit pricing
6. Swipekit ad library MCP
7. Swipekit home page
8. AdLibrarySpy home page and FAQ
9. AdLibrarySpy agent guide (SKILL.md)
10. SpreshApp pricing
11. SpreshApp home page
12. SpreshApp Ad Library MCP
13. SpreshApp Ad Library API
14. Klipio home page and pricing
15. Klipio Claude connector
16. Atria pricing
17. Atria home page
18. Atria MCP
19. Atria MCP quickstart
20. Atria help: choose your plan
21. Atria help: start with the free plan
22. Foreplay pricing
23. Foreplay MCP
24. Foreplay API
25. Foreplay home page
26. Foreplay mobile app
27. Gethookd pricing and FAQ
28. Gethookd home page
29. AdPlexity Social pricing
30. AdPlexity Social MCP
31. AdPlexity Social API
32. AdPlexity Social home page
33. AdPlexity pricing (all products)
34. AdPlexity home page
35. Spytrend pricing
36. Spytrend home page and FAQ
37. Spytrend MCP
38. Motion pricing
39. Motion home page
40. Runneth llm-info
41. Motion help: MCP
42. Motion Creative Strategy Library