# MCP and API: winning Facebook ads data in Claude, ChatGPT and your own tools

Source: https://euwinners.com/features/mcp-api
Updated: 2026-11-20

Short answer: EU Winners has an MCP server and a REST API on every plan. Add one URL as a connector in Claude, ChatGPT or another MCP client, sign in, and your assistant can search winning Facebook ads in Europe, open stores, pages and products, and check your credits. Developers can call the same data with an API key.

## 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)

1. **Copy the connector URL.** In the app, open API in the left menu. The MCP address is https://euwinners.com/api/mcp.
2. **Add it as a custom connector** in Claude, ChatGPT or another assistant that supports MCP connectors.
3. **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

1. **Create a key** on the API page. Give it a name. Copy it when it appears, because it is shown only once.
2. **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.
3. **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](/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](/blog/ad-research-with-claude-and-chatgpt).

## Questions

### Which assistants work with EU Winners?
Any assistant or app that supports MCP connectors with sign-in, including Claude and ChatGPT. Tools that let you set a Bearer token can also connect with an API key instead.

### Do I need an API key for Claude or ChatGPT?
No. Add the connector URL, sign in to EU Winners when asked, and approve the connection. API keys are for your own code and for tools that cannot sign in.

### Is MCP only on the top plan?
No. MCP and API are included in Starter, Growth and Pro, with the same tools on each. The plans differ in credits, seats, the daily digest and support, not in API access.

### Does the API show the same data as the app?
Yes. The MCP tools and the REST API call the same endpoints as the app, with the same filters, the same locked ads and the same credit rules. Ask AI in the app uses the same data too, see [Ask AI](/features/ask-ai).
