TopYappers MCP Server
Give your AI agents access to viral content discovery, influencer search across TikTok, Instagram & YouTube, and trending songs data — all through a single MCP connection.
$ claude mcp add --transport http topyappers https://mcp.topyappers.comViral Content
Discover viral TikTok posts filtered by category, country, virality score, music, hooks, and date ranges.
Creators & Influencers
Search 30M+ creators across TikTok, Instagram, and YouTube with 20+ filters including AI-analyzed niches.
Trending Songs
Access chart rankings, new entries, search by title/artist, track performance history, and compare weeks.
Find What's Going Viral
Your agent can discover trending posts like these — filtered by category, virality score, country, music, and more.
Real viral content discovered through the TopYappers API
Discover Creators Across Platforms
Your agent can search 30M+ creators with 20+ filters — category, followers, engagement, country, AI-analyzed niches, and more.
| Creator | Category | Followers ↕ | Eng. ↑ | Views ↕ | Likes ↕ | Cmts ↕ | Country | Niches | Promotions |
|---|---|---|---|---|---|---|---|---|---|
 Healthcare AI Guy @HealthcareAiGuy | Technology | 10.7K | 0.0% | 0 | 8.8K | 0 | 🇦🇺Australia | AI Software &...+4 more | ChatGPT+1 others |
 AI Space Insider @AISpaceInsider | Technology | 7.6K | 0.0% | 0 | 6.0K | 0 | 🇺🇸United... | AI Software &...+4 more | Seedance 2.0... |
 taylor @taylorwalthall | Fashion | 3.3K | 6.0% | 1.2K | 54 | 3 | 🇺🇸United... | Haircare Pro...+4 more | Electric Cat T... |
 Deo Master @deomaster_ | Technology | 11.3K | 8.0% | 17.0K | 3.7K | 213 | 🇫🇷France | AI Software a...+4 more | ChatGPT+3 others |
 Maisie-Kate @maisiesreads_ | Books & Literature | 2.9K | 12.0% | 0 | 96 | 24 | 🇺🇸United... | book publish...+4 more | kindle+2 others |
Real creator profiles discovered through the TopYappers API
Quick Setup
Two steps — get an API key and add the config to your MCP client.
Get your API key
Sign up or log in to TopYappers and grab your key from the profile page.
Go to profileAdd to your MCP client
Paste the config below into Cursor, Claude Desktop, or any MCP-compatible client. Replace YOUR_API_KEY with your actual key.
Claude Code — CLI
claude mcp add --transport http topyappers https://mcp.topyappers.com \
--header "Authorization: Bearer YOUR_API_KEY"Or add to your project's .mcp.json:
{
"mcpServers": {
"topyappers": {
"type": "http",
"url": "https://mcp.topyappers.com",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Cursor — .cursor/mcp.json
{
"mcpServers": {
"topyappers": {
"url": "https://mcp.topyappers.com",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Claude Desktop — config file
{
"mcpServers": {
"topyappers": {
"url": "https://mcp.topyappers.com",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%/Claude/claude_desktop_config.json
11 Tools Available
Every tool your agent needs to discover content, find creators, and track trending music.
| Tool | Cost |
|---|---|
search_viral_contentFind viral TikTok posts by category, country, views, virality score, dates, music, hooks | 1 credit/result |
search_creatorsSearch influencers across TikTok, Instagram, YouTube with 20+ filters | Free |
get_creator_profilesFetch full creator profiles by IDs — followers, engagement, email, bio, niches | 1 credit/creator |
search_videosSearch videos by engagement metrics, hashtags, text in descriptions | 1 credit/video |
get_song_rankingsCountry or global trending song chart rankings, by week | 10 credits |
get_new_song_entriesNewly charting songs that just entered the rankings | 10 credits |
search_songsSearch songs by title or artist name | 10 credits |
get_song_historyTrack a song's chart performance over time, week by week | 10 credits |
compare_song_rankingsCompare song charts between two different weeks | 10 credits |
get_song_countriesList available countries and codes for song data | 10 credits |
get_song_weeksList available weeks for a specific country | 10 credits |
Example Workflows
What your AI agent can do once connected.
Find viral fitness content from the US
- Agent calls search_viral_content with categories: ["Fitness"], countries: ["United States"], viralityScoreMin: 0.5
- Returns viral videos with view counts, virality scores, hooks, music used, and creator info
Discover fashion influencers on Instagram
- Agent calls search_creators with source: "instagram", mainCategory: "Fashion", followersMin: 50000 (free)
- Agent calls get_creator_profiles with the returned userIds (1 credit each)
- Returns full profiles with email, bio, engagement rate, promoted products, niches
Trending songs report for the UK
- Agent calls get_song_rankings with country: "GB" for current chart
- Agent calls get_new_song_entries with country: "GB" for fresh entries
- Agent calls compare_song_rankings with the two most recent weeks to show movement
Authentication
Your API key is passed as a Bearer token. The MCP server forwards it to the TopYappers API — nothing is stored on the server.
Rate Limits
60 requests per minute per API key. If exceeded, you get a 429 response with a retryAfter value in seconds.
Smart Credit Usage
Creator search is free — agents find IDs first, then only fetch profiles for the ones that matter. Your credits go further.
Full API Documentation
Detailed docs for every endpoint, parameter, response format, enum value, and workflow pattern.