Workspace beta is live — BYO-LLM chat wired to 57 SEC tools. Try it free →
ValueinValuein
state

Get Watchlist

get_watchlist
Free
Pro · Institutional

Fetch a single watchlist (full ticker set + criteria) by its name, not an id (case-insensitive). NOT_FOUND if the name is unknown to this user. 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(
    "get_watchlist",
    arguments={}
)
print(result)

Direct tool call:get_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.

Try this tool

Get tokenAll tools
Categorystate
PIT-safeNo
Min planFree
Inputs0 (0 required)

Plan Access

Free (guest)
Not included
Free (token)
Available
Pro · 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 →