Assistants like Claude and ChatGPT are good at reasoning, summarising and comparing. What they do not have is fresh data on which Facebook ads are winning in Europe this week. MCP (Model Context Protocol) fixes that: it lets your assistant call a data source directly. This guide shows how to connect EU Winners to Claude, ChatGPT or another MCP client, which tools the assistant gets, what to ask, and how credits work.
What you need
- An EU Winners plan. MCP and API access are included in every plan: Starter, Growth and Pro. See pricing.
- An assistant that supports custom MCP connectors, such as Claude or ChatGPT, or another MCP client.
Step 1: Add the connector
- In EU Winners, open MCP and API from the menu. You will see the server address: https://euwinners.com/api/mcp
- In your assistant's settings, add a custom connector (it may be called an MCP server, connector or app) and paste that address.
- The assistant sends you to EU Winners to sign in. Approve the connection.
- That is it. No key to copy. The connection appears under "Connected assistants" on the MCP and API page, where you can disconnect it at any time.
Step 2: Know the tools
Once connected, the assistant can use eight tools. Each one calls the same EU Winners data as the app.
| Tool | What it does | Main options |
|---|---|---|
| search_ads | Finds Meta ads winning in Europe, ranked by EU reach or reach growth | Niche, countries, minimum reach (default 1,000), sort (24 hour gain, 7 day gain, reach, newest), maximum age in days (up to 90), text search in ad copy, page, store or product, store platform (Shopify, WooCommerce, Funnelish, ClickFunnels, CheckoutChamp, Heyflow), number of results (default 10, up to 30) |
| get_ad | Full details of one ad, including reach by country and reach history | Ad ID |
| similar_ads | Ads for the same product, store or page | Ad ID |
| get_store | A store (landing domain): platform, apps, the pages advertising it and daily reach | Domain |
| get_page | A Facebook page: the stores it advertises and its reach | Page ID |
| list_products | Products being advertised, with how many stores sell each and a saturation score | Niche, countries, sort (7 day gain, reach, newest, saturation) |
| get_product | Every store and ad selling one product, first seen date and saturation | Product key |
| credits | Remaining credits for your workspace | None |
Niches are the same as in the app: health, beauty, fashion, pets, home, outdoor, gadgets, travel, software, jewelry, kids and hobby. Countries use two-letter codes such as DE, FR, NL or GB.
Step 3: Ask in plain words
You do not need to name the tools. Ask like you would ask a colleague. Some questions that map well to the tools:
Finding ads
- "Find beauty ads scaling in Germany this week."
- "Show the 10 fashion ads with the most reach gained in the last 24 hours in France."
- "Which home ads started in the last 14 days and already passed 50,000 reach in the Netherlands?"
- "Find ads that send traffic to Funnelish pages in health, in Germany and Austria."
Going deeper on one ad
- "Open the top result and tell me which countries its reach comes from."
- "Find similar ads for the same product and list the stores behind them."
Stores and pages
- "What platform and apps does this store use, and which Facebook pages advertise it?"
- "For this page, list the stores it advertises and its total reach."
Products and saturation
- "List the pet products with the most 7 day reach gain in the EU and their saturation scores."
- "For this product, how many stores sell it and when was it first seen?"
Putting it together
- "Compare the top three growing jewelry ads in Italy and Spain. What do their hooks, offers and stores have in common?"
- "Find a product growing in the Netherlands with almost no reach in Germany yet."
The last kind of question is where an assistant shines: it can run several searches, open the results and write a short comparison for you.
How credits work
The assistant uses your EU Winners account, so credits and plan limits are exactly the same as in the app.
- Each new ad shown to your workspace uses one credit the first time. Opening a new store or page the first time works the same way.
- Seeing the same ad, store or page again is free.
- A search returns 10 ads by default (up to 30), so a broad question can open several new ads at once. Ask for fewer results when you are exploring.
- Ask "how many credits do I have left?" and the assistant uses the credits tool.
Plans: Starter $29 a month with 5,000 credits, Growth $59 with 10,000 credits, Pro $99 with no credit limit under fair use. Prices are before VAT.
Prefer code? Use the API
The same data is available as a REST API. In MCP and API, create an API key and send it as a Bearer token. A request for ads in Germany sorted by 7 day growth looks like this:
curl -H "Authorization: Bearer euw_..." "https://euwinners.com/api/v1/feed?country=DE&sort=gain7d"
Credits work the same as in the app. Keep keys secret and revoke a key in the app if it leaks. API keys also work as a Bearer token for the MCP server, for clients that do not support signing in.
Tips for better answers
- Be specific about market and niche. "Germany, beauty, last 7 days" beats "good ads".
- Ask for growth, not just reach. Growth shows what is being scaled now. See how to find scaling ads.
- Ask the assistant to show its sources. Every ad links back to the Meta Ad Library, so you can check any claim.
- Treat spend as an estimate. Meta does not publish spend for commercial ads. If the assistant mentions spend, it is EU Winners' labelled estimate.
- Follow up on stores. Once you have a good ad, ask about the store behind it. See how to research competitor stores.
Ask AI inside the app
If you would rather not set up an assistant, EU Winners has Ask AI inside the app: plain-language questions answered with real ad cards, stores and products inline. It uses the same data and credits. See Ask AI.
You can also browse without any setup on the public pages: winning ads in the EU or beauty ads in Germany.