Docs
Ctrl+K Search Alt+[Alt+] Guides
Get API key

Integrations

MCP tools reference (simple)

This is the plain-English version of the MCP tools list.

  • MCP URL: https://app.winninghunter.com/mcp
  • Full setup guide: Connect MCP
  • All tools are read-only
  • Successful tools/call uses 1 API credit

Quick list (all 29 tools)

search_tiktok_products
search_tiktok_shops
search_tiktok_creators
search_tiktok_videos
count_tiktok_entities
browse_tiktok_categories
list_tiktok_category_top
autocomplete_tiktok
get_tiktok_product
get_tiktok_shop
get_tiktok_creator
get_tiktok_video
get_tiktok_trending_products
search_facebook_ads
find_winning_products
creative_inspiration_pack
brief_competitor
scan_ad
daily_radar
analyze_tracked_brand
list_tracked_brands
search_shopify_stores
search_shops
find_similar_shops
find_similar_stores_by_image
search_exploding_topics
get_exploding_topic_detail
autocomplete_exploding_topics
check_credits

How to think about the tools

1) Find things

Use these first:

  • search_tiktok_products
  • search_tiktok_shops
  • search_tiktok_creators
  • search_tiktok_videos
  • search_facebook_ads
  • find_winning_products
  • creative_inspiration_pack
  • brief_competitor
  • scan_ad
  • search_shopify_stores
  • search_shops
  • find_similar_shops
  • find_similar_stores_by_image
  • search_exploding_topics

2) Open details

Use an ID from search results:

  • get_tiktok_product
  • get_tiktok_shop
  • get_tiktok_creator
  • get_tiktok_video
  • get_exploding_topic_detail

3) Helpers

  • count_tiktok_entities (counts by entity)
  • browse_tiktok_categories (category tree and views)
  • list_tiktok_category_top (top items in one category)
  • autocomplete_tiktok (typeahead suggestions)
  • autocomplete_exploding_topics (topic suggestions)
  • get_tiktok_trending_products (TikTok Shop trending)
  • daily_radar (tracked-brand changes)
  • analyze_tracked_brand (single-brand deep dive)
  • check_credits (remaining API credits)

Most common arguments

Most search tools use these:

  • keyword
  • country
  • page
  • size
  • sort_by
  • sort_order

For Meta ad tools (search_facebook_ads, find_winning_products), sort_by is not arbitrary. Use one of:

  • relevance
  • datefound
  • lastseen
  • adspend
  • longestrunning
  • reach
  • adsetamount
  • consistency
  • monthlyvisits
  • pageactiveads

Common aliases are auto-normalized by MCP:

  • created, created_at, date, recent, newest, latest -> datefound
  • last_ad_started -> lastseen
  • first_ad_started, oldest, earliest -> datefound with ascending order

Most detail tools use:

  • id
  • slice (which part you want)

Slice values for detail tools

Use one of these slice values:

  • get_tiktok_product: detail, history, metrics, creators, videos
  • get_tiktok_shop: detail, history, metrics, products, videos, creators, strategy
  • get_tiktok_creator: detail, history, metrics, shops, products, videos
  • get_tiktok_video: detail, history, metrics, products, similar

Two easy mistakes

  1. Trending confusion

    • get_tiktok_trending_products is TikTok Shop product momentum
    • Exploding Topics is separate (search_exploding_topics + get_exploding_topic_detail)

  2. Write actions

    • MCP is read-only
    • Favorites, presets, transcripts, and other writes must use REST API

Copy block for AI instructions

Paste this into agent instructions:

Use WinningHunter MCP at https://app.winninghunter.com/mcp.
Auth can be either OAuth bearer token (connector flow) or X-API-Key (header-capable clients).
All MCP tools are read-only.
Successful tools/call costs 1 API credit.
If user asks for writes (favorites/presets/transcripts), use REST /api/v1/tiktok-shop/* instead.
When unsure about exact schema, call tools/list first.

Need the full technical detail?

For full filter semantics and endpoint behavior: