Valuein
reports

List My Research Reports

list_my_reports
Benchmark and above

Cursor-paginated newest-first listing of the caller's own reports (owner-scoped). Filters compose with AND; `status` defaults to 'ready' so pass status='draft' or 'all' to see drafts. Use `cursor` from the previous response's `next_cursor` to fetch the next page (limit max 100...

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

Direct tool call:list_my_reports(...)

Inputs

ParameterTypeRequiredDescription
status"draft" | "ready" | "listed" | "delisted" | "all"optionalFilter by status. Default 'ready' (excludes drafts + delisted).Default: "ready"
report_type"reverse_dcf"optionalFilter by report type.
tickerstringoptionalFilter to a single ticker (case-insensitive).
limitintegeroptionalPage size.Default: 20
cursorstringoptionalCursor from previous `next_cursor`.

Output Fields

reportsnext_cursor

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
{  "reports": null,  "next_cursor": 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 tokenAll tools
Categoryreports
PIT-safeNo
Min planBenchmark
Inputs5 (0 required)

Plan Access

Sample (guest)
Not included
Benchmark (token)
Available
Pro
Available
Institutional
Available

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