What inputs does score_claim accept?

claim_id (string, required): Id of the claim to resolve. as_of (string, optional): Snapshot date for the fundamentals window (auto mode). Defaults to today UTC. manual_status ("confirmed" | "refuted" | "expired" | "stale" | "needs_review", optional): Provide to record a human/agent outcome instead of auto-grading. manual_score (number|null, optional): Outcome score in [-1,1] for a manual resolution. Null for non-scored statuses. manual_reason (string, optional): Explanation for a manual resolution.

Which Valuein plans include score_claim?

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

Discovery

Score Claim

score_claim

Benchmark and above

Resolve a claim's outcome. By default auto-grades an `auto` claim by evaluating its verifiable_condition against SEC fundamentals (confirmed/refuted), or marks it `needs_review` when it can't be resolved deterministically (judgment, antecedent, or missing data). To record a hu...

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

Direct tool call:score_claim(...)

Inputs

Parameter	Type	Required	Description
`claim_id`	string	required	Id of the claim to resolve.
`as_of`	string	optional	Snapshot date for the fundamentals window (auto mode). Defaults to today UTC.
`manual_status`	"confirmed" \| "refuted" \| "expired" \| "stale" \| "needs_review"	optional	Provide to record a human/agent outcome instead of auto-grading.
`manual_score`	number\|null	optional	Outcome score in [-1,1] for a manual resolution. Null for non-scored statuses.
`manual_reason`	string	optional	Explanation for a manual resolution.

Output Fields

claimmoderesolved_statusscorebasisreasondeduplicated

Example Response

Illustrative

response.jsonjson

{  "claim": null,  "mode": null,  "resolved_status": null,  "score": null,  "basis": null,  "reason": null,  "deduplicated": 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

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