Give your AI agent ad and store intelligence
The SellWinners MCP server exposes our data as 73 tools. Point any MCP client at the endpoint, sign in from ChatGPT or Claude or add your API key, and your agent can search ads, inspect Shopify stores, search their products and pull creatives on its own.
- Streamable HTTP
- Sign-in for ChatGPT and Claude, or your API key
- Shares your plan's credits
# Endpoint https://mcp.sellwinners.com/mcp # Transport streamable HTTP # Auth OAuth sign-in (ChatGPT, Claude) # or X-API-Key: YOUR_API_KEY # or Authorization: Bearer YOUR_API_KEY
Three steps to your first agent call
Sign in or create a key
Start free, then sign in from ChatGPT or Claude, or create a key in your dashboard. The Free plan includes the MCP server too: 150 credits a month, 10 requests a minute, the first 10 results of each search.
Add the server to your client
Paste the configuration below into Cursor, VS Code, Claude or any client with remote MCP support.
Ask your agent
Try “find the top video ads for running shoes this month”. Your agent picks the right tool by itself.
Set it up in your client
ChatGPT and Claude sign in; elsewhere, replace YOUR_API_KEY with a key from your dashboard.
No API key: these sign in with your SellWinners account. The Free plan includes the MCP server too: 150 credits a month, 10 requests a minute, the first 10 results of each search. 1. In ChatGPT (an app or a connector in developer mode) or in Claude (Customize → Connectors → Add custom connector; on Team or Enterprise an Owner adds it and you select Connect), add this server URL: https://mcp.sellwinners.com/mcp 2. Choose OAuth if asked. A SellWinners window opens: log in, then select Allow. 3. Ask: "Find the top video ads for running shoes this month". Disconnect any time: Settings → MCP → Connected apps.
// ~/.cursor/mcp.json
{
"mcpServers": {
"sellwinners": {
"url": "https://mcp.sellwinners.com/mcp",
"headers": { "X-API-Key": "YOUR_API_KEY" }
}
}
}
// .vscode/mcp.json
{
"servers": {
"sellwinners": {
"type": "http",
"url": "https://mcp.sellwinners.com/mcp",
"headers": { "X-API-Key": "YOUR_API_KEY" }
}
}
}
// claude_desktop_config.json (needs Node.js; uses the mcp-remote bridge)
{
"mcpServers": {
"sellwinners": {
"command": "npx",
"args": ["-y", "[email protected]", "https://mcp.sellwinners.com/mcp",
"--header", "X-API-Key:YOUR_API_KEY"]
}
}
}
Server URL: https://mcp.sellwinners.com/mcp
Transport: streamable HTTP
Header: X-API-Key: YOUR_API_KEY
(or Authorization: Bearer YOUR_API_KEY)
73 tools, ready to use
Open a tool to see the arguments it takes. Highlighted ones are required.
Discovery
3 toolslookupResolve a brand name, a shop domain or a Facebook page id to ids you can use with the other tools
3 arguments
lookup_filter_idsIds for the filters of the search tools
7 arguments
list_saved_viewsThe searches you saved on the website's list pages, ready for the search tools
1 argument
Shops
17 toolssearch_shopsSearch or browse Shopify stores
48 arguments
find_similar_shopsCompetitors of a shop (id or domain)
10 arguments
find_winning_productsProducts selling now in a niche
5 arguments
search_productsSearch or browse store products by price, sales, units sold, selling countries, ads, reach, reviews, launch date, currency or shop country
37 arguments
search_products_by_imageFind store products that look like a picture (an image URL or the file), with their shops
12 arguments
search_shops_by_imageFind the shops selling what a picture shows, with their closest products
7 arguments
get_productOne product with its full sheet: photos, options and variants
2 arguments
get_product_adsThe Meta ads that link to a product's page
5 arguments
analyze_productOne product, its latest ads and a read of its signals
3 arguments
product_launch_radarProducts launched recently, ranked by sales or ad pressure
34 arguments
create_product_share_linkCreate (or return) the public link to one product
2 arguments
delete_product_share_linkRemove the public link to one product
2 arguments
brief_competitorA compact brief on one competitor (shop id, domain or name)
11 arguments
shop_reportOne report on a shop: its feed, its Facebook pages, Q4 season, a landing page, its ad ranking or its creative tests
19 arguments
compare_shopsOne figure of several shops side by side
3 arguments
market_overviewThe whole market, day by day, or over a Q4 season
5 arguments
detect_shopify_storeWhether a store runs on Shopify, its theme and the Shopify apps it loads
1 argument
Ads and media
8 toolssearch_adsSearch Meta (Facebook / Instagram) ads by words in the copy, brand or landing page
97 arguments
scan_adThe full record of one Meta ad (or of one Google ad or TikTok post)
1 argument
creative_inspiration_packCreative inspiration for a niche
5 arguments
search_google_ads_librarySearch Google ads
57 arguments
search_tiktok_librarySearch TikTok ads and organic posts
66 arguments
create_ad_share_linkCreate (or return) the public link to one ad
2 arguments
delete_ad_share_linkRemove the public link to one ad
2 arguments
write_ad_hooksWrite three short opening lines (hooks) for an ad of a product, for Meta, TikTok or both
7 arguments
Advertisers and emails
5 toolssearch_advertisersSearch advertisers (Facebook pages)
26 arguments
scan_advertiserOne advertiser's record, or its live ads and reach day by day
4 arguments
search_emailsSearch brands' marketing emails by words in the subject, sender or content
11 arguments
get_email_htmlThe raw HTML of one email (use search_emails first to find the id)
4 arguments
analyze_shop_emailsA shop's email strategy
2 arguments
Tracked brands
14 toolslist_tracked_brandsThe brands you track, with their live ad counters
6 arguments
add_to_brandtrackerStart tracking a brand
5 arguments
delete_from_brandtrackerStop tracking a brand
3 arguments
list_brandtracker_foldersYour tracker folderscreate_brandtracker_folderCreate a tracker folder
1 argument
rename_brandtracker_folderRename a tracker folder
2 arguments
delete_brandtracker_folderDelete a tracker folder
3 arguments
move_tracked_brandsMove tracked brands into a folder (folder_id=null takes them out of any folder)
3 arguments
get_brand_activityWhat a tracked brand did across Meta, TikTok, Google and email
11 arguments
analyze_tracked_brandA deep look at one tracked brand
4 arguments
analyze_brand_changesWhat changed for a tracked brand over a period (1d, 7d, 14d, 30d; rank gained is read over 7d for 1d, hooks over 30d for 14d, creative tests are the latest)
6 arguments
get_brandtracker_scaling_adsThe ads of a tracked brand that gained the most rank, with their rank history
32 arguments
get_brandtracker_transcriptsVideo scripts of a tracked brand, grouped by text
9 arguments
daily_radarDaily digest across your tracked brands
4 arguments
Boards
14 toolslist_boardsYour boards
8 arguments
get_boardOne board
1 argument
create_boardCreate a board
6 arguments
update_boardRename a board, change its description or its visibility
4 arguments
move_boardMove a board under a folder board (parent_board_id=null moves it to the top level)
2 arguments
archive_boardArchive a board and everything under it (restore_board brings it back)
2 arguments
restore_boardRestore an archived board
1 argument
list_board_itemsThe items saved on a board
3 arguments
find_saved_itemsSearch everything you saved, on every board and in your favorites
13 arguments
add_board_itemSave an item on a collection board
5 arguments
move_board_itemMove a saved item to another board
4 arguments
remove_board_itemRemove a saved item from a board
3 arguments
create_board_share_linkCreate a public link to a board
2 arguments
delete_board_share_linkRemove the public links to a board
2 arguments
Favorites
10 toolslist_favoritesYour saved ads, shops or emails
6 arguments
add_favorite_itemSave an ad, a shop or an email
4 arguments
move_favorite_itemMove a saved favorite to a folder (folder_id=null moves it out of any folder)
4 arguments
remove_favorite_itemRemove a saved favorite, by its own id (favorite_id) or by the id of the saved record (item_id)
5 arguments
create_favorite_folderCreate a favorite folder
4 arguments
update_favorite_folderRename a favorite folder, or move it (move=true with parent_id, null for the top level)
6 arguments
delete_favorite_folderDelete a favorite folder
6 arguments
set_favorite_folder_visibilityMake a favorite folder private or shared
4 arguments
create_favorite_folder_share_linkCreate a public link to a favorite folder
4 arguments
delete_favorite_folder_share_linkRemove the public links to a favorite folder
4 arguments
Account
2 toolsusage_getYour plan, its credits and how many are leftcheck_creditsHow many credits you have left this month (same answer as usage_get)usage_get and check_credits cost nothing. The server also exposes three resources: sellwinners://me, sellwinners://usage and sellwinners://openapi.Troubleshooting
- 401, or the client asks you to sign in again: the key was revoked or mistyped, or the sign-in ended. Make a new key under API keys, or reconnect the app.
- A tool answers insufficient_credits: this month's credits are used up. The call didn't run and cost nothing; the answer gives the day the credits renew. Paid plans can add credits on the billing page.
- 403 plan_not_eligible: the plan doesn't include this tool or the MCP server. The answer names the feature; plans are on the pricing page.
- A tool answers rate_limited: the per-minute rate limit, shared by the workspace. The call didn't run and cost nothing; wait the seconds the answer gives, then retry.
- A connected app stopped working: disconnect it under Settings, MCP, Connected apps, then connect it again. A connection unused for 60 days ends by itself.
- Something else: write to support with the time of the call and the tool's name.