TopYappers MCP#

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.

Setup#

MCP Endpoint: https://mcp.topyappers.com Transport: HTTP Auth: Bearer token in the Authorization header

Get an API key at topyappers.com/profile.

Claude Code#

text

claude mcp add --transport http topyappers https://mcp.topyappers.com \
  --header "Authorization: Bearer YOUR_API_KEY"

.mcp.json / Cursor / Claude Desktop#

json

{
  "mcpServers": {
    "topyappers": {
      "type": "http",
      "url": "https://mcp.topyappers.com",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Available Skills#

This package includes 4 specialized skills for each API domain:

• find-creators — Search 30M+ creators with 20+ filters (category, niche, followers, engagement, country, platform). Free search + paid profiles.
• find-viral-content — Discover viral TikTok posts by category, country, virality score, date range, music, and hooks.
• search-videos — Find videos by engagement metrics, hashtags, text search, and sort by views/likes/shares.
• trending-songs — Chart rankings, new entries, song search, history tracking, and week-over-week comparisons across 44 countries.

11 MCP Tools#

ToolDescriptionCostsearch_creatorsSearch influencers with 20+ filtersFreeget_creator_profilesFull profiles — followers, engagement, email, bio, niches1 credit/creatorsearch_viral_contentViral TikTok posts by category, country, virality score1 credit/resultsearch_videosVideos by engagement, hashtags, text1 credit/videoget_song_rankingsCountry or global chart rankings10 creditsget_new_song_entriesNewly charting songs10 creditssearch_songsSearch by title/artist10 creditsget_song_historySong chart performance over time10 creditscompare_song_rankingsCompare charts between two weeks10 creditsget_song_countriesAvailable countries for song data10 creditsget_song_weeksAvailable weeks for a country10 credits

Quick Reference#

Country format matters#

• Creators & viral content → full names: "United States", "France"
• Song tools → country codes: "US", "FR", "GB"

nichesToPromote is the primary creator discovery tool#

The most powerful filter. It uses AI-analyzed niche data that is very granular — specific products ( calorie counter, standing desk), use cases ( meal prep, budget travel), audiences ( new moms, small business owners), and tools ( ChatGPT, Notion). Be specific and creative.

Run 5+ niche searches per query#

nichesToPromote, promotedProducts, and hashtags use AND logic when comma-separated — never pass multiple values. Instead, run at least 5 searches with different keywords from different angles, then merge and deduplicate. Since search is free, there's no cost.

Credit-efficient creator workflow#

1. search_creators (free) with nichesToPromote → run 5+ searches with different keywords
2. Deduplicate all userIds across searches
3. get_creator_profiles (1 credit each) → only for the ones you need

Virality score#

Views ÷ followers, normalized 0–1. Use 0.3+ for quality, 0.5+ for highly viral, 0.7+ for breakout content.

Song week format#

ISO format: YYYY-Www (e.g. "2026-W04"). Use get_song_weeks to discover available weeks.

Rate Limits#

60 requests per minute per API key. HTTP 429 responses include retryAfter in seconds.

Links#

• TopYappers Platform
• API Documentation
• MCP Documentation
• GitHub