Overview
The bigdata_delete_watchlist tool permanently deletes one or more watchlists from your Bigdata.com account. Only watchlists the caller owns can be deleted. The watchlists disappear from the Bigdata App as well.
Deletion is permanent and cannot be undone through the MCP tools.
When to Use
Delete Watchlist is ideal for:
- Cleaning up: Removing temporary watchlists created for a one-off screen or comparison
- Retiring lists: Deleting a portfolio or comps set that is no longer tracked
- Bulk removal: Deleting several watchlists in a single call
How It Works
- List owned watchlists with
bigdata_get_watchlist if the user has not supplied the IDs
- Confirm with the user which watchlists to delete, by name
- Call
bigdata_delete_watchlist with the list of IDs
- Verify by listing owned watchlists again
Parameters
Important Notes
- Never guess IDs. Take them from
bigdata_get_watchlist or from the watchlist URL in the Bigdata App
- An unknown ID returns an error, for example
Watchlist <id> not found
- Watchlists shared with you but owned by someone else cannot be deleted through this tool
Data Returned
Returns a JSON object confirming the deleted watchlists:
Usage Monitoring
The tool bigdata_delete_watchlist does not consume any quota.
Practical Tips
Delete instead of emptying
To stop tracking a list entirely, delete the watchlist rather than removing all of its items with bigdata_edit_watchlist. To keep the list but change its contents, use edit instead.
