What inputs does score_due_claims accept?

customer_id (string, optional): Target user's Stripe customer_id. 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 claims scored per call (default 100). as_of (string, optional): Snapshot date for the fundamentals window. Defaults to today UTC.

Which Valuein plans include score_due_claims?

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

Discovery

Score Due Claims (bulk auto-grader)

score_due_claims

Benchmark and above

Find every auto-gradable claim that is due (assertions in open/needs_review/stale; predictions whose horizon has passed) and resolve each against fundamentals. Operates on the caller's OWN claims — omit `customer_id`. Targeting another user's `customer_id` is reserved for Valu...

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

Direct tool call:score_due_claims(...)

Inputs

Parameter	Type	Required	Description
`customer_id`	string	optional	Target user's Stripe customer_id. 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 claims scored per call (default 100).
`as_of`	string	optional	Snapshot date for the fundamentals window. Defaults to today UTC.

Output Fields

target_customer_idscannedduescoredneeds_reviewskippederrorsresults

Example Response

Illustrative

response.jsonjson

{  "target_customer_id": null,  "scanned": null,  "due": null,  "scored": null,  "needs_review": null,  "skipped": null,  "errors": null,  "results": null}