# TopYappers

# TopYappers

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add top/yappers

# Browse available tools
npx -y @smithery/cli@latest tool list top/yappers

# Get full schema for a tool
npx -y @smithery/cli@latest tool get top/yappers search_viral_content

# Call a tool
npx -y @smithery/cli@latest tool call top/yappers search_viral_content '{}'
```

## Direct MCP Connection

Endpoint: `https://topyappers.run.tools`

**Required config:**
- `API-key` (header) — API key . Can be obtained on https://www.topyappers.com/profile/api

## Tools (11)

- `search_viral_content` — Discover viral TikTok content. Filter by content category, country, view count, virality score (views÷followers ratio, …
- `search_creators` — Search for influencers and creators across TikTok, Instagram, and YouTube. Filter by followers, average views, engageme…
- `get_creator_profiles` — Fetch full creator/influencer profiles by their IDs (obtained from search_creators). Returns detailed profiles includin…
- `search_videos` — Search for video content from TikTok, Instagram, and YouTube. Filter by creator handle, follower count, views, likes, c…
- `get_song_rankings` — Get trending song chart rankings for a specific country or globally. Pass a country code (e.g. 'US', 'GB', 'FR') for co…
- `get_new_song_entries` — Get songs that newly entered the chart for a specific country. Shows fresh trending songs that just appeared on the ran…
- `search_songs` — Search for songs by title or artist name. Returns matching songs with chart performance data. Costs 10 credits per requ…
- `get_song_history` — Get the full chart performance history of a specific song over time. Shows rank progression week by week. Requires song…
- `compare_song_rankings` — Compare song chart rankings between two different weeks for a country. Shows position changes, new entries, and drops b…
- `get_song_countries` — Get the list of available countries (with their codes) for the Songs API. Use this to discover valid country codes befo…
- `get_song_weeks` — Get available weeks for a specific country in the Songs API. Use this to discover valid week values before querying ran…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get top/yappers <tool-name>
```

## Prompts (4)

- `find_viral_content` (topic, country) — Discover viral TikTok content for a specific niche or topic. Returns a guided workflow to find the most viral posts.
- `find_creators_for_product` (product, platform, country) — Find influencers/creators who would be a great fit for promoting a specific product or service. Uses the free search + …
- `trending_songs_report` (country_code) — Generate a trending songs report for a country — current rankings, new entries, and week-over-week changes.
- `competitor_content_analysis` (username, platform) — Analyze a specific creator's content — find their videos, see what performs well, and discover similar creators in the …