Get the Creators in a Watchlist: MCP Tool for AI Agents

Returns a single watchlist by watchlistId with every member profile: profileId, handle, platform and follower count. Free to call. Use it to review or explain a list before searching it, or to pick profileIds for remove_watchlist_profiles.

Fetch one watchlist with all of its member creators, each with the internal profileId, handle, platform and follower count. Free to call. It is how an agent shows the owner what a list contains, checks whether a creator is already in it, or picks ids to remove.

FreeRead-only

How agents use it

Connect the Viral Outliers MCP server once and the get_watchlist tool becomes available to your agent alongside all other skills:

claude mcp add --transport http viral-outliers https://viraloutliers.com/api/mcp \
  --header "Authorization: Bearer so_live_YOUR_KEY"

In Claude.ai or ChatGPT, add a custom connector pointing at https://viraloutliers.com/api/mcp. Your agent then calls get_watchlist on its own whenever the task needs it.

Parameters

NameTypeDescription
watchlistId*string (path)Watchlist id from list_watchlists or create_watchlist.

What it does

Returns the watchlist's metadata plus a profiles array. Each member carries its profileId (usable with get_profile, compare_profiles and remove_watchlist_profiles), handle, platform and follower count, newest additions first.

Pricing

This skill is free and never spends credits.

Agent workflows

  • Review: get_watchlist → summarize members to the user → remove_watchlist_profiles for the ones to drop.

Frequently asked questions

How do I check which creators are in a watchlist?

Call get_watchlist with the watchlistId. The response lists every member with handle, platform, follower count and profileId.