What inputs does list_watchlists accept?

status ("active" | "archived" | "all", optional, default "active"): Filter by state; defaults to `active`. Use `all` to include archived watchlists. limit (integer, optional, default 20): Maximum number of watchlists to return (1–100). Defaults to 20. cursor (string, optional): Opaque pagination cursor from a previous response; omit for the first page.

Which Valuein plans include list_watchlists?

Available on the free tier (token required) and on Pro and Institutional. Not point-in-time safe.

state

List Watchlists

list_watchlists

Benchmark and above

Paginated newest-first listing of the caller's watchlists (id, name, tickers, status, counts). Filter by `status` (active/archived/all). Returns metadata only — use get_watchlist for one list's full ticker set, or watchlist_diff for new filings across a list. Tier: sp500+ (sam...

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(    "list_watchlists",    arguments={})print(result)

Direct tool call:list_watchlists(...)

Inputs

Parameter	Type	Required	Description
`status`	"active" \| "archived" \| "all"	optional	Filter by state; defaults to `active`. Use `all` to include archived watchlists.Default: `"active"`
`limit`	integer	optional	Maximum number of watchlists to return (1–100). Defaults to 20.Default: `20`
`cursor`	string	optional	Opaque pagination cursor from a previous response; omit for the first page.

Output Fields

watchlistsnext_cursortotal_count

Paging

Pass the next_cursor of one result as cursor on the next call, with the same other arguments. A null next_cursor is the last page.

Errors and paging for every tool: the agent contract.

Example Response

Illustrative

response.jsonjson

{  "watchlists": null,  "next_cursor": null,  "total_count": null}

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 the Benchmark plan and above.

Try this tool

Get token All tools

Categorystate

PIT-safeNo

Min planBenchmark

Inputs3 (0 required)

Plan Access

Sample (guest)

Not included

Benchmark (token)

Available

Pro

Available

Institutional

Available

Related Tools

search_companies

Search Companies

get_company_fundamentals

Company Fundamentals

get_valuation_metrics

Valuation Metrics

get_financial_ratios

Financial Ratios

Resources

Point-in-Time methodology →Parquet schema reference →Bulk Data API reference →Python SDK guide →

Index names are trademarks of their owners; Valuein is not affiliated with or endorsed by any index provider.