top-yappers
mcpsmithery# 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 available countries for song data | 10 credits | | `get_song_weeks` | List available weeks for a country | 10 credits | ## Use cases - **Influencer marketing** — Find creators in specific niches who match a brand's target audience, with contact emails and engagement data - **Content strategy** — Analyze what's going viral in your category to inform content creation - **Trend monitoring** — Track trending songs and sounds before they peak, ideal for music marketing and content timing - **Competitive intelligence** — Discover which products competitors are promoting through influencers - **Market research** — Understand engagement patterns across countries, categories, and platforms ## Key features - **Credit-efficient design** — Creator search is free; agents find matching IDs first, then only fetch profiles for relevant creators - **Rich filtering** — 20+ filters for creators including AI-analyzed `nichesToPromote` for semantic niche matching - **Cross-platform** — Single interface for TikTok, Instagram, and YouTube data - **Built-in agent guidance** — Includes detailed instructions and prompt templates to help agents use tools effectively - **No data stored** — API keys are forwarded as Bearer tokens; nothing is stored on the server ## Authentication Requires a TopYappers API key passed as a Bearer token in the `Authorization` header. Get a key at [topyappers.com/profile](https://www.topyappers.com/profile). ## Links - [TopYappers Platform](https://www.topyappers.com) - [API Documentation](https://docs.topyappers.com) - [MCP Documentation](https://www.topyappers.com/mcp) - [GitHub](https://github.com/topyappers/topyappers-mcp)
By Smithery | 25 findings | Scanned 7/15/2026 | tooltrust-scanner/v0.3.19
Risk Summary
Safe With Normal ControlsDep Visibility is the main signal, but overall risk remains within an acceptable range.
Potential impact: This finding indicates the tool should be reviewed before it is trusted.
Recommended action: No high-risk findings were detected in this scan, but you should still apply least-privilege defaults and rescan after changes.
Suggested policy: keep this tool behind manual approval, do not allow unattended runs, and re-scan after narrowing risky permissions.
Security Findings (25)
input schema exposes 14 properties (threshold: 10)
search_viral_contentinput schema exposes 22 properties (threshold: 10)
search_creatorsinput schema exposes 17 properties (threshold: 10)
search_videosFix: Tool requests broad permissions (exec/fs/network). Validate input parameters using Enums where possible, and restrict file system operations to explicit allowed directories.
tool performs network or execution operations but declares no rate-limit, timeout, or retry configuration
search_viral_contentsearch_creatorsget_creator_profilessearch_videossearch_songsFix: Declare explicit rate-limit, timeout, and retry configuration for all network and execution tools. Implement exponential back-off and surface resource state to the calling agent.
declared capabilities: network access
search_viral_contentsearch_videossearch_songsdeclared capabilities: network access, filesystem access
search_creatorsget_creator_profilesdeclared capabilities: database access
get_song_weeksFix: Tool requests broad permissions (exec/fs/network). Validate input parameters using Enums where possible, and restrict file system operations to explicit allowed directories.
Tool did not expose metadata.dependencies or repo_url, so supply-chain coverage is limited.
search_viral_contentsearch_creatorsget_creator_profilessearch_videosget_song_rankingsget_new_song_entriessearch_songsget_song_historycompare_song_rankingsget_song_countriesget_song_weeksFix: Review and remediate the identified issue.
Scan this tool yourself
Reproduce this audit locally, integrate into CI, or let your agent audit its own tools.
Install once, then scan any MCP server:
$ curl -sfL https://raw.githubusercontent.com/AgentSafe-AI/tooltrust-scanner/main/install.sh | bash$ tooltrust-scanner scan --server "npx -y top-yappers"Adjust the package name if your npm registry name differs from the tool ID. View source
Add badge to your README
Copy this Markdown to show your ToolTrust grade on GitHub.
[](https://github.com/AgentSafe-AI/tooltrust-directory)