What inputs does create_report accept?

report_type ("reverse_dcf" | "thesis", required): Subtype. `reverse_dcf` requires ticker + params; `thesis` requires thesis_id (from save_thesis / list_theses). ticker (string, optional): US-listed ticker — required for report_type=reverse_dcf. Case-insensitive. params (object, optional): Reverse-DCF parameters — required for report_type=reverse_dcf. thesis_id (string, optional): Id of a saved thesis owned by the caller — required for report_type=thesis. title (string, optional): Optional human-supplied title; auto-generated when omitted. idempotency_key (string, optional): Optional key for at-most-once semantics. Same key from the same user always yields the same report id.

Which Valuein plans include create_report?

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

reports

Create Research Report

create_report

Benchmark and above

Synchronously generate a research report and persist it under the caller's authorship. Two subtypes: • `reverse_dcf` — solves the stage-1 free-cash-flow growth rate the market price implies, with a 5×5 sensitivity grid across WACC × terminal-growth assumptions. Returns full ma...

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(    "create_report",    arguments={    "report_type": "reverse_dcf"})print(result)

Direct tool call:create_report(...)

Inputs

Parameter	Type	Required	Description
`report_type`	"reverse_dcf" \| "thesis"	required	Subtype. `reverse_dcf` requires ticker + params; `thesis` requires thesis_id (from save_thesis / list_theses).
`ticker`	string	optional	US-listed ticker — required for report_type=reverse_dcf. Case-insensitive.
`params`	object	optional	Reverse-DCF parameters — required for report_type=reverse_dcf.
`thesis_id`	string	optional	Id of a saved thesis owned by the caller — required for report_type=thesis.
`title`	string	optional	Optional human-supplied title; auto-generated when omitted.
`idempotency_key`	string	optional	Optional key for at-most-once semantics. Same key from the same user always yields the same report id.

Output Fields

reportsectionscitationsstructuredmarkdown

Example Response

Illustrative

response.jsonjson

{  "report": null,  "sections": null,  "citations": null,  "structured": null,  "markdown": 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

Categoryreports

PIT-safeNo

Min planBenchmark

Inputs6 (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.