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

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

.mcp.json / Cursor / Claude Desktop

{
  "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

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