What inputs does watchlist_diff accept?

name (string, optional): Name of a watchlist the caller has already saved. Pass this OR `tickers`, never both. tickers (array, optional): Tickers or CIKs to scan, passed directly. Use this for an ad-hoc question — do NOT create a watchlist in order to ask one, since that writes a durable record into the user's account. Pass this OR `name`, never both. since (string, required): Cutoff date (YYYY-MM-DD); the diff returns SEC filings whose filing_date is on or after this date. form_types (array, optional): Filing forms to include. Defaults to 10-K + 10-Q + 8-K.

Which Valuein plans include watchlist_diff?

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

Discovery

Watchlist Diff

watchlist_diff

Benchmark and above

Return new SEC filings across a set of companies since a given date. Name the companies EITHER with `name` (a watchlist you have already saved) OR with `tickers` (a list you are holding right now) — pass exactly one. Use `tickers` for an ad-hoc question: there is no need to cr...

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(    "watchlist_diff",    arguments={    "since": "EXAMPLE"})print(result)

Direct tool call:watchlist_diff(...)

Inputs

Parameter	Type	Required	Description
`name`	string	optional	Name of a watchlist the caller has already saved. Pass this OR `tickers`, never both.
`tickers`	array	optional	Tickers or CIKs to scan, passed directly. Use this for an ad-hoc question — do NOT create a watchlist in order to ask one, since that writes a durable record into the user's account. Pass this OR `name`, never both.
`since`	string	required	Cutoff date (YYYY-MM-DD); the diff returns SEC filings whose filing_date is on or after this date.
`form_types`	array	optional	Filing forms to include. Defaults to 10-K + 10-Q + 8-K.

Output Fields

watchlist_namesincetickers_scannedtickers_requestedtruncatedtickers_failedfilings

Example Response

Illustrative

response.jsonjson

{  "watchlist_name": null,  "since": null,  "tickers_scanned": null,  "tickers_requested": null,  "truncated": null,  "tickers_failed": null,  "filings": null}