{
 "retrievedOn": "2026-10-08",
 "source": "tools/list from the TokConnect MCP server",
 "serverVersion": "2.23.9",
 "toolCount": 83,
 "groups": [
  {
   "group": "Search demand (Creator Search Insights)",
   "count": 12,
   "tools": [
    {
     "name": "list_channels",
     "title": "List CSI channels",
     "description": "Lists the topic feeds and trending categories that browse_topics and trending_topics accept."
    },
    {
     "name": "list_languages",
     "title": "List CSI languages",
     "description": "Lists the language codes search_topics and browse_topics accept."
    },
    {
     "name": "search_topics",
     "title": "Search CSI topics",
     "description": "Finds TikTok searches matching a keyword, with each one's 7-day search popularity (searchVolume), video count and daily trend. A videoCount of 0 marks a content gap. Use queryId with the topic tools."
    },
    {
     "name": "browse_topics",
     "title": "Browse CSI topic feeds",
     "description": "Lists TikTok searches from a feed: suggested, content gaps, searches by followers, trending, or a category. Use list_channels for the options."
    },
    {
     "name": "trending_topics",
     "title": "CSI trending topics",
     "description": "Lists TikTok's trending searches, optionally for one category, with searchVolume and video counts."
    },
    {
     "name": "topic_detail",
     "title": "CSI topic detail",
     "description": "Returns one topic (query_id): searchVolume, trend, category and top countries."
    },
    {
     "name": "search_popularity",
     "title": "CSI popularity chart",
     "description": "Returns a topic's daily search popularity over 7-180 days, globally or per country. Values are TikTok's popularity readings, not monthly search counts; never add days together. Countries without data are listed as missing."
    },
    {
     "name": "audience_demographics",
     "title": "CSI topic audience",
     "description": "Returns the age, gender and location split of people searching a topic (query_id)."
    },
    {
     "name": "related_topics",
     "title": "CSI related topics",
     "description": "Lists searches TikTok relates to one topic (query_id), with their searchVolume."
    },
    {
     "name": "related_queries",
     "title": "CSI related queries",
     "description": "Returns follow-up searches TikTok links to a topic (query_id)."
    },
    {
     "name": "content_guidance",
     "title": "CSI creator guidance",
     "description": "Returns TikTok's content suggestions for a topic (query_id). TikTok has not generated them for many topics; then available is false."
    },
    {
     "name": "related_videos",
     "title": "CSI topic to videos",
     "description": "Returns videos TikTok shows for a topic (query_id)."
    }
   ]
  },
  {
   "group": "Search",
   "count": 9,
   "tools": [
    {
     "name": "search_videos",
     "title": "Search videos",
     "description": "Searches TikTok videos by keyword. sort (relevance, most_liked, newest) and date (day to half_year) are applied by TikTok. Returns posts with views, likes, comments, shares, saves, creator, hashtags, sound and linked Shop products."
    },
    {
     "name": "search_photos",
     "title": "Search photo posts",
     "description": "Searches photo carousel posts by keyword."
    },
    {
     "name": "search_users",
     "title": "Search accounts",
     "description": "Searches TikTok accounts by keyword, with follower filters and sorting. If TikTok's account search is not answering, the call says so."
    },
    {
     "name": "search_hashtags",
     "title": "Search hashtags",
     "description": "Finds hashtags by keyword, with views and video counts."
    },
    {
     "name": "search_sounds",
     "title": "Search sounds",
     "description": "Searches TikTok sounds by keyword: title, author, original or licensed, and posts using each."
    },
    {
     "name": "search_live",
     "title": "Search LIVE rooms",
     "description": "Searches LIVE broadcasts by keyword, with viewers and whether the room sells Shop products."
    },
    {
     "name": "search_suggestions",
     "title": "Search autocomplete",
     "description": "Returns TikTok's search autocomplete for a keyword. user_only=true suggests accounts. Works when full search is rate limited."
    },
    {
     "name": "search_all",
     "title": "Mixed search",
     "description": "Mixed TikTok search (videos, accounts and more in one list). Often empty; search_videos and search_users search one type at a time."
    },
    {
     "name": "trending_searches",
     "title": "Web trending searches",
     "description": "Returns the trending search phrases TikTok's website shows. Not search volumes; use trending_topics for those."
    }
   ]
  },
  {
   "group": "Videos and comments",
   "count": 7,
   "tools": [
    {
     "name": "video_detail",
     "title": "Video or photo post detail",
     "description": "Returns one post (video or photo carousel) by id: counts, creator, hashtags, sound, place, linked Shop products and caption tracks."
    },
    {
     "name": "similar_videos",
     "title": "Similar videos",
     "description": "Returns videos TikTok relates to one video (video_id). If TikTok returns none, the call says so; search_videos on its hashtags finds neighbours."
    },
    {
     "name": "video_comments",
     "title": "List video comments",
     "description": "Returns a video's top-level comments with likes and reply counts. sort relevant (TikTok's order) or newest. Use comment_replies for a thread."
    },
    {
     "name": "comment_replies",
     "title": "List comment replies",
     "description": "Returns the replies to one comment (aweme_id and comment_id)."
    },
    {
     "name": "video_captions",
     "title": "Download caption file",
     "description": "Downloads one caption file (WebVTT) by its URL from video_detail captions. video_transcript does the lookup and returns plain text instead."
    },
    {
     "name": "video_transcript",
     "title": "Video captions as text",
     "description": "Returns a video's existing TikTok captions as plain text with timed segments, preferring the requested language. Nothing is transcribed; many videos have no captions."
    },
    {
     "name": "pick_comment_winners",
     "title": "Comment giveaway draw",
     "description": "Draws giveaway winners at random from a video's comments, with optional filters (must_include, unique users, exclude the creator). A seed makes the draw reproducible. Reports how many comments were eligible."
    }
   ]
  },
  {
   "group": "Creators",
   "count": 16,
   "tools": [
    {
     "name": "user_profile",
     "title": "Creator profile",
     "description": "Returns a creator's public profile by @handle: followers, likes, videos, bio, bio link, verification, Shop seller status and ids for the other creator tools."
    },
    {
     "name": "user_profile_by_id",
     "title": "Creator profile by secUid",
     "description": "Returns a creator's public profile by secUid (from posts or comments)."
    },
    {
     "name": "creator_posts",
     "title": "Creator post feed",
     "description": "Returns a creator's posts, newest first (up to 35 per call), with counts, hashtags, sound and linked Shop products. Needs sec_uid from user_profile."
    },
    {
     "name": "creator_reposts",
     "title": "Creator reposts",
     "description": "Returns posts a creator reposted. Needs sec_uid."
    },
    {
     "name": "creator_likes",
     "title": "Creator public likes",
     "description": "Returns posts on a creator's public Liked tab. Empty when the creator hides likes. Needs sec_uid."
    },
    {
     "name": "creator_stories",
     "title": "Creator stories",
     "description": "Returns a creator's live Stories. Stories expire; none means none are up now. Needs the numeric user_id."
    },
    {
     "name": "embed_videos",
     "title": "Creator embed feed",
     "description": "Returns the posts TikTok shows in a creator's embed widget, a shorter list than creator_posts. Needs sec_uid."
    },
    {
     "name": "creator_playlists",
     "title": "Creator playlists",
     "description": "Lists a creator's public playlists. Needs sec_uid."
    },
    {
     "name": "playlist_detail",
     "title": "Playlist detail",
     "description": "Returns one playlist: name, video count and creator."
    },
    {
     "name": "playlist_videos",
     "title": "Playlist videos",
     "description": "Returns the videos in a creator's playlist (playlist_id from creator_playlists)."
    },
    {
     "name": "creator_collections",
     "title": "Creator collections",
     "description": "Lists a creator's public saved collections. TikTok often returns this empty. Needs sec_uid."
    },
    {
     "name": "collection_detail",
     "title": "Collection detail",
     "description": "Returns one saved collection: name, video count and owner."
    },
    {
     "name": "collection_videos",
     "title": "Collection videos",
     "description": "Returns the videos in a saved collection."
    },
    {
     "name": "creator_followers",
     "title": "Creator followers",
     "description": "Returns a creator's followers when TikTok shows the list. TikTok hides most follower lists from outside viewers; then the call says so. Needs sec_uid and user_id."
    },
    {
     "name": "creator_following",
     "title": "Accounts a creator follows",
     "description": "Returns accounts a creator follows when TikTok shows the list. Usually hidden; then the call says so. Needs sec_uid and user_id."
    },
    {
     "name": "creator_products",
     "title": "Products a creator promotes",
     "description": "Lists the TikTok Shop products a creator links in recent posts, with post count, views and likes per product. Not the full showcase tab, and not sales."
    }
   ]
  },
  {
   "group": "Hashtags, sounds, effects and places",
   "count": 15,
   "tools": [
    {
     "name": "hashtag_detail",
     "title": "Hashtag detail",
     "description": "Returns one hashtag (hashtag_id): views, video count and description."
    },
    {
     "name": "hashtag_videos",
     "title": "Hashtag video feed",
     "description": "Returns videos using a hashtag. sort hot (TikTok's ranking) or newest."
    },
    {
     "name": "related_hashtags",
     "title": "Related hashtags",
     "description": "Returns hashtags TikTok relates to one hashtag."
    },
    {
     "name": "discover_hashtags",
     "title": "Discover hashtag catalog",
     "description": "Returns TikTok's Discover hashtags with a few sample videos each."
    },
    {
     "name": "discover_cards",
     "title": "Share Discover cards",
     "description": "Returns TikTok's Discover picks: creators, hashtags and sounds."
    },
    {
     "name": "sound_detail",
     "title": "Sound detail",
     "description": "Returns one sound (music_id): title, author, duration, original or licensed, and posts using it."
    },
    {
     "name": "sound_videos",
     "title": "Videos using a sound",
     "description": "Returns videos using a sound (music_id)."
    },
    {
     "name": "hot_sounds",
     "title": "Hot sounds catalog",
     "description": "Returns TikTok's catalogue of currently hot original sounds."
    },
    {
     "name": "music_choices",
     "title": "Licensed music choices",
     "description": "Returns TikTok's licensed music catalogue (tracks cleared for use)."
    },
    {
     "name": "music_beats",
     "title": "Recommended beats catalog",
     "description": "Returns TikTok's recommended beats catalogue."
    },
    {
     "name": "sticker_detail",
     "title": "Effect/sticker detail",
     "description": "Returns one effect (sticker_id): name, creator, posts using it and views."
    },
    {
     "name": "sticker_videos",
     "title": "Videos using an effect/sticker",
     "description": "Returns videos using an effect (sticker_id)."
    },
    {
     "name": "sticker_discover",
     "title": "Effect-discover video feed",
     "description": "Returns videos from TikTok's effect discovery feed; their effects carry sticker ids."
    },
    {
     "name": "place_detail",
     "title": "Place / POI detail",
     "description": "Returns a tagged place (place_id from a post): name, category, address and videos tagged there."
    },
    {
     "name": "place_videos",
     "title": "Place tagged videos",
     "description": "Returns videos tagged at a place (place_id from video_detail or place_detail)."
    }
   ]
  },
  {
   "group": "Discovery and LIVE",
   "count": 5,
   "tools": [
    {
     "name": "explore_categories",
     "title": "List Explore categories",
     "description": "Lists TikTok Explore categories and their ids."
    },
    {
     "name": "explore_videos",
     "title": "Explore category videos",
     "description": "Returns videos from a TikTok Explore category (category_id from explore_categories)."
    },
    {
     "name": "recommended_videos",
     "title": "For You recommendations",
     "description": "Returns a page of TikTok's For You feed as a neutral US viewer sees it. A sample, not a ranking."
    },
    {
     "name": "live_room_detail",
     "title": "LIVE room snapshot",
     "description": "Returns one LIVE room (room_id): title, creator, live or ended, viewers, likes and Shop selling."
    },
    {
     "name": "live_gifts",
     "title": "LIVE gift catalog",
     "description": "Lists TikTok LIVE gifts with their coin prices."
    }
   ]
  },
  {
   "group": "TikTok Shop",
   "count": 12,
   "tools": [
    {
     "name": "search_shop_products",
     "title": "Search Shop products",
     "description": "Searches TikTok Shop products by keyword: price, units sold (TikTok's displayed count), rating, reviews and shop. Also returns filter ids, related searches and categories. sort: best_sellers, newest, price_asc, price_desc."
    },
    {
     "name": "shop_product_detail",
     "title": "Shop product page",
     "description": "Returns a Shop product page: price, units sold, rating, variants with stock, categories, delivery, shop stats, the page's creator videos (with commission labels) and related products."
    },
    {
     "name": "shop_product_reviews",
     "title": "Shop product reviews",
     "description": "Returns a product's public reviews. sort recommended or newest; filter all, with_media or verified; stars 1-5. TikTok shows outside viewers only the first reviews of each product."
    },
    {
     "name": "shop_product_videos",
     "title": "Shop product videos",
     "description": "Returns the creator videos on a product page (up to 20), with views and TikTok's 'Creator earns commission' label."
    },
    {
     "name": "shop_related_products",
     "title": "Related Shop products",
     "description": "Returns products TikTok shows as related to one product."
    },
    {
     "name": "shop_seller",
     "title": "Shop seller store",
     "description": "Returns a Shop seller's store: rating, units sold, followers and products."
    },
    {
     "name": "shop_suggest",
     "title": "Shop search suggestions",
     "description": "Returns TikTok Shop's search autocomplete for a keyword."
    },
    {
     "name": "shop_deals",
     "title": "Shop deals feed",
     "description": "Returns TikTok Shop's deals feed (US). Merchandising, not a ranking."
    },
    {
     "name": "shop_category",
     "title": "Shop category page",
     "description": "Returns a Shop category page's products (category_id and slug from search_shop_products relatedCategories)."
    },
    {
     "name": "shop_keyword_page",
     "title": "Shop keyword landing page",
     "description": "Returns a Shop keyword page's products (slug from search_shop_products relatedSearches)."
    },
    {
     "name": "shop_catalog",
     "title": "Shop catalog page",
     "description": "Returns any other public Shop page by path: empty for the homepage, deals/flash-sales, deals/premium-offers, store/{slug}/{seller_id}, blog/{slug}. Prefer the dedicated Shop tools when they fit."
    },
    {
     "name": "find_affiliates",
     "title": "Creators promoting a product",
     "description": "Finds creators posting videos linked to a Shop product, from the product page and video search. Returns creators ranked by views on those videos, commission labels and ad permission. Not sales per creator."
    }
   ]
  },
  {
   "group": "Creative Center and ads",
   "count": 7,
   "tools": [
    {
     "name": "creative_top_contents",
     "title": "Creative Center trending videos",
     "description": "Returns Creative Center's trending videos by market (JP, VN, TH, ID return data; US is usually empty), with views and engagement rate."
    },
    {
     "name": "creative_seo_list",
     "title": "Creative One SEO list",
     "description": "Lists Creative Center's public SEO inspiration names by type (keyword, hashtag, selling_points, top_content, top_ads). Some types are empty."
    },
    {
     "name": "creative_seo_detail",
     "title": "Creative One SEO detail",
     "description": "Returns Creative Center detail for names from creative_seo_list."
    },
    {
     "name": "creative_partner_filters",
     "title": "Creative partner filter catalog",
     "description": "Lists the markets and date range the Creative Partner leaderboard covers."
    },
    {
     "name": "creative_partner_leaderboard",
     "title": "Creative partner leaderboard",
     "description": "Returns TikTok Creative Partner agencies for a market (country_code from creative_partner_filters)."
    },
    {
     "name": "ad_library_regions",
     "title": "Ad Library regions",
     "description": "Lists the EU and UK regions TikTok's Ad Library covers."
    },
    {
     "name": "ad_library_suggest",
     "title": "Ad Library suggestions",
     "description": "Returns Ad Library autocomplete: advertiser names with ids and ad keywords. Not an ad search."
    }
   ]
  }
 ]
}