What inputs does list_theses accept?

ticker (string, optional): Filter to theses on this ticker (case-insensitive). view ("bull" | "bear" | "neutral", optional): Filter to a single view. status ("active" | "closed" | "archived" | "all", optional, default "active"): 'active' (default) hides archived theses; pass 'all' to include them. limit (integer, optional, default 20): Page size, 1–100. Defaults to 20. cursor (string, optional): Pagination cursor returned by the previous `list_theses` call's `next_cursor`.

Which Valuein plans include list_theses?

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

state

List Saved Theses

list_theses

Benchmark and above

Return the caller's saved theses, newest-first. Filters: ticker (exact), view, status. Cursor-based pagination — pass `next_cursor` from the previous response to fetch the next page. Sample tier rejected (no per-user state).

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

Direct tool call:list_theses(...)

Inputs

Parameter	Type	Required	Description
`ticker`	string	optional	Filter to theses on this ticker (case-insensitive).
`view`	"bull" \| "bear" \| "neutral"	optional	Filter to a single view.
`status`	"active" \| "closed" \| "archived" \| "all"	optional	'active' (default) hides archived theses; pass 'all' to include them.Default: `"active"`
`limit`	integer	optional	Page size, 1–100. Defaults to 20.Default: `20`
`cursor`	string	optional	Pagination cursor returned by the previous `list_theses` call's `next_cursor`.

Output Fields

thesesnext_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

{  "theses": 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

Inputs5 (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.