Valuein
state

Score Thesis Outcome

score_thesis_outcome
Benchmark and above

Grade a saved thesis against fundamental momentum since its creation. Pulls revenue / operating-margin / EPS / OCF deltas and aggregates into a score in [-1, +1]. Bull theses are graded by directional alignment, bear by inverse, neutral by closeness-to-flat. The grade is persi...

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

Direct tool call:score_thesis_outcome(...)

Inputs

ParameterTypeRequiredDescription
thesis_idstring
required
Id returned by `save_thesis` or `list_theses`.
as_ofstringoptionalSnapshot date for the 'current' fundamentals window. Defaults to today UTC. The scorer picks the fiscal period closest to this date.

Output Fields

thesisoutcome

Example Response

Illustrative
response.jsonjson
{  "thesis": null,  "outcome": 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
Categorystate
PIT-safeNo
Min planBenchmark
Inputs2 (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.