Model Context Protocol

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.

Terminal

claude mcp add --transport http topyappers https://mcp.topyappers.com/mcp

Get API Key View on GitHub

MCP Tools

30M+

Creators Indexed

Platforms

60/min

Rate Limit

Capabilities

What your agents get

Docs ↗

Viral 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.

Compatibility

Use with any AI tool

If it speaks MCP, it works with TopYappers. These are the ones we see most — but any client can connect.

Claude Code

setup guide ↗

Claude Web

OAuth connector ↗

Claude Desktop

OAuth connector ↗

Cursor

setup guide ↗

Codex

setup guide ↗

Windsurf

setup guide ↗

VS Code

setup guide ↗

Zed

setup guide ↗

Gemini CLI

setup guide ↗

Cline

VS Code extension

Roo Code

VS Code extension

Continue

IDE extension

JetBrains

AI Assistant

OpenCode

CLI agent

Amp

CLI agent

Goose

CLI agent

Warp

Terminal

Don't see your tool? Anything that speaks MCP works — point it at https://mcp.topyappers.com/mcp with an Authorization header.

Viral Content Discovery

Find What's Going Viral

Your agent can discover trending posts like these — filtered by category, virality score, country, music, and more.

Viral

Real viral content discovered through the TopYappers API

Creator & Influencer Search

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

Setup Guides

Connect in under a minute

Pick your tool, paste one snippet, done. Every guide uses the same API key from your profile page. Replace YOUR_API_KEY with your actual key.

Get your API key

01Grab your API key from the profile page on TopYappers.
02Run the command below in your terminal — or add the JSON to your project's .mcp.json.
03Start claude and run /mcp to confirm topyappers is connected.

Terminal

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

.mcp.json

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

Already connected? Nothing to update — the server is remote, so new tools and fixes ship automatically. Only edit your config to rotate an API key: update the Authorization header (Claude Code: claude mcp remove topyappers, then re-add).

Tools

11 Tools Available

Every tool your agent needs to discover content, find creators, and track trending music.

Full reference ↗

Tool	Description	Cost
`search_viral_content` Find viral TikTok posts by category, country, views, virality score, dates, music, hooks	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	Search influencers across TikTok, Instagram, YouTube with 20+ filters	Free
`get_creator_profiles` Fetch full creator profiles by IDs — followers, engagement, email, bio, niches	Fetch full creator profiles by IDs — followers, engagement, email, bio, niches	1 credit/creator
`search_videos` Search videos by engagement metrics, hashtags, text in descriptions	Search videos by engagement metrics, hashtags, text in descriptions	1 credit/video
`get_song_rankings` Country or global trending song chart rankings, by week	Country or global trending song chart rankings, by week	10 credits
`get_new_song_entries` Newly charting songs that just entered the rankings	Newly charting songs that just entered the rankings	10 credits
`search_songs` Search songs by title or artist name	Search songs by title or artist name	10 credits
`get_song_history` Track a song's chart performance over time, week by week	Track a song's chart performance over time, week by week	10 credits
`compare_song_rankings` Compare song charts between two different weeks	Compare song charts between two different weeks	10 credits
`get_song_countries` List available countries and codes for song data	List available countries and codes for song data	10 credits
`get_song_weeks` List available weeks for a specific country	List available weeks for a specific country	10 credits

Example Workflows

What your AI agent can do

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

Key Details

Good to know

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.

Documentation

Full API Documentation

Detailed docs for every endpoint, parameter, response format, enum value, and workflow pattern.

Read the Docs Get API Key