ValueinValuein
state

Archive Watchlist

delete_watchlist
Free
Pro · Institutional

Soft-delete a watchlist by its name (not id): status flips to `archived` (still readable via list_watchlists status=all/archived). The name is freed for reuse by a new save_watchlist. Idempotent. Tier: sp500+ (sample rejected).

Example Call

example_call.pypython
# Using the Valuein MCP server from Python (via MCP SDK)# Or call directly from Claude / Cursor after setup result = await client.call_tool(    "delete_watchlist",    arguments={})print(result)

Direct tool call:delete_watchlist(...)

Inputs

This tool takes no inputs.

Output Fields

Example Response

Illustrative
response.jsonjson
{}

Shape only — field names match the live schema; values are placeholders, not real filings. See MCP server for the structured response shape.

Notes

Available from sp500 tier and above.