TopYappers
https://server.smithery.ai/top/yappers/mcp# 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)
MCP readiness
Readiness is how fully this listing follows its protocol and how it behaved in our probes over 30 days. It is shown for reference and does not move it in search. Search order and leaderboards use the separate quality grade (here C+, 70.0/100), which weighs availability, conformance, p95 speed and descriptor. How the two differ
| Valid MCP handshake | 10/10 | initialize and tools/list both answered. |
| Live MCP endpoint | 24/25 | Endpoint answers the MCP initialize handshake (4871 ms); slow response -1. |
| Protocol revision | 5/10 | Speaks MCP 2025-03-26, 3 revision(s) behind 2026-07-28. |
| Signed descriptor | n/a | No MCP standard defines a signed server descriptor. |
| Uptime (30 days) | 15/15 | 31/31 probes succeeded over 30 days (100%). |
| Tool declaration | 10/10 | Lists 14 tool(s) with descriptions. |
| Verified identity | 5/10 | Publisher declared (repository, package or homepage); claim this listing to verify domain control. |
| Freshness + modern flags | 4/5 | seen in a source within 7 days. |
| Auth declaration | 2/5 | Declares credential scheme: smithery_api_key. |
Compared with peers
Against 53,039 reachable MCP servers in our daily snapshot (2026-11-12 06:46 UTC). Display only; it does not change search order.
- Readiness
- Higher than 60% of peers
- This listing 83 · peer median 81
- Latency
- Faster than 26% of peers
- This listing 542 ms · peer median 326 ms
Where it loses the most points, and how to win them back
- Protocol revision −5
— Support the current protocol revision.
Now: Speaks MCP 2025-03-26, 3 revision(s) behind 2026-07-28.
- Verified identity −5
— Claim the listing and prove control of its domain.
Now: Publisher declared (repository, package or homepage); claim this listing to verify domain control.
- Auth declaration −3
— State how to authenticate (an auth scheme, or that none is needed).
Now: Declares credential scheme: smithery_api_key.
Listed in
Directories this entry was found in.
How to connect
https://server.smithery.ai/top/yappers/mcpcurl -X POST https://server.smithery.ai/top/yappers/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'