What the MCP server and API are
MCP (Model Context Protocol) is the standard way for AI assistants to use outside tools. EU Winners runs an MCP server, so an assistant you already use can search our data on your behalf: "find beauty ads scaling in Germany this week" becomes a real search on EU Winners, with real ads in the answer.
The REST API is the same data for your own code: scripts, spreadsheets, internal dashboards or alerts. Both use the same rules as the app. What you can see, and what uses credits, does not change with the way you ask.
Why it matters for finding winning products in Europe
Ad research rarely ends in the ad spy tool. You compare ads with your own sales data, draft test plans, brief a creative team, or keep a running list of products to try. When your assistant can reach EU Winners directly, you can do all of that in one conversation:
- Pull this week's top scaling ads in a market and ask the assistant to group them by angle.
- Look up a competitor's store and every page advertising it.
- Check how crowded a product is before you order samples.
- Feed the results into your own notes, documents or code.
The data stays the same as in the app: ads past 1,000 EU reach, ranked by the reach Meta publishes, with the store, page and product behind each one.
How to use it in three steps
Connect an assistant (MCP)
- Copy the connector URL. In the app, open API in the left menu. The MCP address is https://euwinners.com/api/mcp.
- Add it as a custom connector in Claude, ChatGPT or another assistant that supports MCP connectors.
- Sign in and approve. Your assistant sends you to EU Winners to sign in and approve the connection. No key to copy. Connected assistants are listed on the API page, where you can disconnect them at any time.
Use the REST API
- Create a key on the API page. Give it a name. Copy it when it appears, because it is shown only once.
- Send it as a Bearer token with each request, for example to /api/v1/feed?country=DE&sort=gain7d for ads in Germany sorted by reach gained in 7 days.
- Revoke keys you no longer use from the same page.
What your assistant can do
The MCP server gives assistants eight tools:
| Tool | What it does |
|---|---|
search_ads | Find winning EU ads by niche, country, minimum reach, sort (reach gained 24h or 7d, total reach, newest), ad age, store platform and text search |
get_ad | Full details of one ad, including reach by country and reach history |
similar_ads | Other ads for the same product, store or page |
get_store | A store: platform, apps, the pages advertising it and daily reach |
get_page | A Facebook page: the stores it advertises and its reach |
list_products | Products being advertised, with how many stores sell each and a saturation score |
get_product | Every store and ad selling one product, first seen date and saturation |
credits | How many credits your workspace has left |
The REST API covers the same ground: the feed with all its filters, single ads, similar ads, stores, pages, products and credits.
What you get back
Results are the same ad cards the app shows, as data: EU reach, reach gained in 24 hours and 7 days, reach by country, age and gender split, start date, active or stopped, niche, format, ad text and headline, call to action, store domain and platform, product, landing page type and price, Facebook page, estimated spend (always an estimate, Meta does not publish spend for these ads) and a link to the ad in the Meta Ad Library.
Which plans include it
MCP and API are included in every plan: Starter ($29 a month), Growth ($59) and Pro ($99), before VAT. You need a plan to create API keys.
Credits work exactly as in the app. Each new ad, store, page or product costs one credit the first time your workspace opens it, then stays free. Filters and repeat lookups are free. Starter has 5,000 credits a month, Growth 10,000, and Pro has no credit limit under fair use. When an assistant searches, the ads it shows count like ads shown in the feed, so ask for 10 ads, not 100, unless you need them. The search_ads tool returns 10 ads by default. See pricing.
Good questions to ask your assistant
- "Use EU Winners to find the 10 home ads that gained the most reach in France in the last 7 days, and group them by product."
- "Look up this store in EU Winners and tell me which pages advertise it and which apps it uses."
- "List pet products in EU Winners sorted by saturation and tell me which ones look early."
- "Compare what is scaling in the Netherlands and Belgium this week."
For more ideas, read ad research with Claude and ChatGPT.