Deletes one of your watchlists including its memberships, and frees the watchlist slot and followed-profile slots it used. Free to call. Works for lists created through the API or in the web app; only the owner can delete a list.
Remove a watchlist and everything in it in one free call. The watchlist slot and every followed-profile slot it used are released back to your allowance, so cleaning up temporary lists is how an agent keeps room for new ones.
Connect the Viral Outliers MCP server once and the delete_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 delete_watchlist on its own whenever the task needs it.
| Name | Type | Description |
|---|---|---|
watchlistId* | string | Watchlist id (query string or JSON body). |
Deletes the watchlist and its memberships and returns deleted:true. Any list you own is eligible, whether it was created through the API or in the web app; the allowance bookkeeping is identical on both surfaces.
This skill is free and never spends credits.
Yes. Deleting releases the watchlist slot and one followed-profile slot per creator that was in it, so you can create a new list or add creators elsewhere immediately.
Also available as a REST API endpoint.
Related topics: watchlist cleanup · temporary creator lists