What inputs does score_due_theses accept?

customer_id (string, optional): Stripe customer_id of the target user. Defaults to the caller's own — leave it unset. Supplying a DIFFERENT customer_id is restricted to Valuein's internal scoring service and is rejected on every plan, Institutional included. max (integer, optional): Soft cap on theses scored per call. Defaults to 100. The frontend cron walks users serially so a low cap per user keeps each MCP request bounded. as_of (string, optional): Snapshot date for the 'current' fundamentals window. Defaults to today UTC.

Which Valuein plans include score_due_theses?

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

Discovery

Score Due Theses (bulk auto-grader)

score_due_theses

Benchmark and above

Find every thesis past its horizon with no outcome yet, and grade each via `score_thesis_outcome`. Operates on the caller's OWN theses — omit `customer_id`. Targeting another user's `customer_id` is reserved for Valuein's internal scoring service and is rejected for every plan...

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

Direct tool call:score_due_theses(...)

Inputs

Parameter	Type	Required	Description
`customer_id`	string	optional	Stripe customer_id of the target user. Defaults to the caller's own — leave it unset. Supplying a DIFFERENT customer_id is restricted to Valuein's internal scoring service and is rejected on every plan, Institutional included.
`max`	integer	optional	Soft cap on theses scored per call. Defaults to 100. The frontend cron walks users serially so a low cap per user keeps each MCP request bounded.
`as_of`	string	optional	Snapshot date for the 'current' fundamentals window. Defaults to today UTC.

Output Fields

target_customer_idscannedduescoredskippederrorsresults

Example Response

Illustrative

response.jsonjson

{  "target_customer_id": null,  "scanned": null,  "due": null,  "scored": null,  "skipped": null,  "errors": null,  "results": 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

CategoryDiscovery

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.