Returns every watchlist on the account (both agent-created and web-app-created) with its watchlistId, name, notes, profile count and last-updated time. Free to call. Use it to recall an id for search_outliers, add_watchlist_profiles or get_watchlist.
See every watchlist on the account in one free call, with the id an agent needs to search it, the name, how many creators it holds and when it was last changed. It covers lists built in the web app as well as lists an agent created through the API, so the agent can reuse whatever the owner has already curated.
Connect the Viral Outliers MCP server once and the list_watchlists 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 list_watchlists on its own whenever the task needs it.
Returns an array of watchlists ordered by most recently updated, each with watchlistId, name, notes, profileCount, timestamps and a source flag (api or app). It is the lookup step before a scoped search or a membership change.
At the start of a session to discover the owner's existing lists ("search my competitors" resolves to a watchlistId here), or after creating lists to confirm ids. Pair with get_watchlist when you also need the member profiles.
This skill is free and never spends credits.
Call list_watchlists. It returns every watchlist on the account, including web-app-created ones, with the watchlistId to pass to search_outliers.
Also available as a REST API endpoint.
Related topics: watchlist ids · creator list lookup · agent session bootstrap