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 | 27 findings | Scanned 5/22/2026 | tooltrust-scanner/v0.3.12
Risk Summary
Needs ApprovalExcessive Permissions plus Dep Visibility raises enough risk that this tool should not be auto-trusted.
Potential impact: The agent may gain overly broad access to files, network, databases, or execution capabilities.
Recommended action: Keep this tool behind manual approval and avoid unattended runs until the risky capabilities are narrowed or removed.
Suggested policy: keep this tool behind manual approval, do not allow unattended runs, and re-scan after narrowing risky permissions.
Security Findings (27)
tool declares network permission
search_viral_contentsearch_creatorsget_creator_profilessearch_videossearch_songsFix: Tool requests broad permissions (exec/fs/network). Validate input parameters using Enums where possible, and restrict file system operations to explicit allowed directories.
tool declares fs permission
search_creatorsget_creator_profilestool declares db permission
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.
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.
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)