TopYappers
# TopYappers Social media intelligence for AI agents. Access viral content discovery, influencer search across TikTok, Instagram & YouTube, and trending song charts — all through a single MCP connection. ## What it does TopYappers gives AI agents real-time access to social media data across three domains: - **Viral Content** — Discover trending TikTok posts filtered by category, country, virality score (views÷followers), date range, music/sound, and opening hooks. Understand what's going viral and why. - **Creators & Influencers** — Search a database of 30M+ creators across TikTok, Instagram, and YouTube using 20+ filters including AI-analyzed niches, promoted products, follower ranges, engagement rates, country, language, and hashtags. Creator search is free — you only pay when fetching full profiles. - **Trending Songs** — Access weekly song chart rankings by country, track new chart entries, search by title or artist, view historical performance, and compare charts week-over-week. ## Tools | Tool | Description | Cost | |------|-------------|------| | `search_viral_content` | Find viral TikTok posts by category, country, views, virality score, dates, music, hooks | 1 credit/result | | `search_creators` | Search influencers across TikTok, Instagram, YouTube with 20+ filters | **Free** | | `get_creator_profiles` | Fetch full creator profiles — followers, engagement, email, bio, niches, promoted products | 1 credit/creator | | `search_videos` | Search videos by engagement metrics, hashtags, text in descriptions | 1 credit/video | | `get_song_rankings` | Country or global trending song chart rankings | 10 credits | | `get_new_song_entries` | Newly charting songs that just entered rankings | 10 credits | | `search_songs` | Search songs by title or artist name | 10 credits | | `get_song_history` | Track a song's chart performance over time | 10 credits | | `compare_song_rankings` | Compare song charts between two weeks | 10 credits | | `get_song_countries` | List
https://topyappers.run.tools
How to connect
-
Smithery (hosted)
1. Open https://smithery.ai/servers/top/yappers 2. Click Connect and complete OAuth in your MCP client (Claude, Cursor, VS Code, etc.) 3. MCP endpoint: https://topyappers.run.tools
Tools (11)
-
search_viral_contentDiscover viral TikTok content. Filter by content category, country, view count, virality score (views÷followers ratio, 0–1), date range, music/sound title, and opening hook text. Returns video URLs, engagement metrics, virality scores, and creator info. Costs 1 credit per result.
-
search_creatorsSearch for influencers and creators across TikTok, Instagram, and YouTube. Filter by followers, average views, engagement rate, content category, country, language, bio keywords, promoted products, niches, hashtags, username, and email. This endpoint is FREE — it returns creator IDs. Pass those IDs to get_creator_profiles to fetch full profiles with details. The 'nichesToPromote' filter is especially powerful for AI-analyzed niche matching (e.g. 'SaaS', 'skincare', 'fitness supplements').
-
get_creator_profilesFetch full creator/influencer profiles by their IDs (obtained from search_creators). Returns detailed profiles including follower count, average views, engagement rate, categories, bio, promoted products, niches, country, email, hashtags, and more. Costs 1 credit per creator returned.
-
search_videosSearch for video content from TikTok, Instagram, and YouTube. Filter by creator handle, follower count, views, likes, comments, shares, hashtags, and text search in descriptions/captions. Sort by views, likes, shares, or follower count. Returns video metadata, engagement metrics, and subtitles. Costs 1 credit per video returned.
-
get_song_rankingsGet trending song chart rankings for a specific country or globally. Pass a country code (e.g. 'US', 'GB', 'FR') for country-specific charts, or set global=true for worldwide rankings. Optionally specify a week in ISO format (YYYY-Www, e.g. '2026-W04'). Omit week for the latest data. Costs 10 credits per request.
-
get_new_song_entriesGet songs that newly entered the chart for a specific country. Shows fresh trending songs that just appeared on the rankings. Costs 10 credits per request.
-
search_songsSearch for songs by title or artist name. Returns matching songs with chart performance data. Costs 10 credits per request.
-
get_song_historyGet the full chart performance history of a specific song over time. Shows rank progression week by week. Requires song_id (obtainable from get_song_rankings or search_songs results) and a country_code. Costs 10 credits per request.
-
compare_song_rankingsCompare song chart rankings between two different weeks for a country. Shows position changes, new entries, and drops between the two weeks. Costs 10 credits per request.
-
get_song_countriesGet the list of available countries (with their codes) for the Songs API. Use this to discover valid country codes before calling other song tools. Costs 10 credits per request.
-
get_song_weeksGet available weeks for a specific country in the Songs API. Use this to discover valid week values before querying rankings or comparisons. Costs 10 credits per request.