What inputs does compute_dcf accept?

ticker (string, required): Stock ticker symbol of the company to value, e.g. AAPL, MSFT, BRK.B. stage1_growth_rate (number, required): Stage-1 FCF growth rate (e.g. 0.12 = 12%/yr). wacc (number, optional, default 0.09): Discount rate. Default 0.09. terminal_growth_rate (number, optional, default 0.025): Long-run growth. Default 0.025. stage1_years (integer, optional, default 5): Number of explicit high-growth projection years before the terminal stage (3–15). Defaults to 5. fcf_base_override (number, optional): Override the auto-pulled FCF base (USD). Leave unset to use R2-derived. shares_override (number, optional): Override shares outstanding. Leave unset to use R2-derived. as_of_date (string, optional): Point-in-time cutoff (YYYY-MM-DD) for the auto-pulled inputs. Fundamentals are filtered by SEC accepted_at (strict PIT); valuation.parquet inputs are best-effort PIT (filtered by created_at, its accepted_at proxy — no SEC acceptance timestamp exists for pipeline-computed valuations). Omit to use the latest knowable inputs. fcf_source ("trend" | "three_statement", optional, default "trend"): "trend" (default): compound fcf_base by stage1_growth_rate every year (unchanged original behavior). "three_statement": derive the FCF stream from a full linked 3-statement projection instead — see the tool description for details. three_statement_assumptions (object, optional): Only used when fcf_source is "three_statement". Overrides for the underlying projection; unset fields use project_three_statement's defaults.

Which Valuein plans include compute_dcf?

Available on the free tier (token required) and on Pro and Institutional. Point-in-time safe via as_of_date filtering.

Valuation

PIT-safe

Compute Forward DCF

compute_dcf

Benchmark and above

Forward discounted-cash-flow valuation (two-stage Gordon-growth model): caller provides growth + WACC + terminal assumptions, returns per-share intrinsic value (`value_per_share_cents`, cents of `result.reporting_currency` — USD for US filers, the filer's own currency otherwis...

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(    "compute_dcf",    arguments={    "ticker": "EXAMPLE",    "stage1_growth_rate": 10})print(result)

Direct tool call:compute_dcf(...)

Inputs

Parameter	Type	Required	Description
`ticker`	string	required	Stock ticker symbol of the company to value, e.g. AAPL, MSFT, BRK.B.
`stage1_growth_rate`	number	required	Stage-1 FCF growth rate (e.g. 0.12 = 12%/yr).
`wacc`	number	optional	Discount rate. Default 0.09.Default: `0.09`
`terminal_growth_rate`	number	optional	Long-run growth. Default 0.025.Default: `0.025`
`stage1_years`	integer	optional	Number of explicit high-growth projection years before the terminal stage (3–15). Defaults to 5.Default: `5`
`fcf_base_override`	number	optional	Override the auto-pulled FCF base (USD). Leave unset to use R2-derived.
`shares_override`	number	optional	Override shares outstanding. Leave unset to use R2-derived.
`as_of_date`	string	optional	Point-in-time cutoff (YYYY-MM-DD) for the auto-pulled inputs. Fundamentals are filtered by SEC accepted_at (strict PIT); valuation.parquet inputs are best-effort PIT (filtered by created_at, its accepted_at proxy — no SEC acceptance timestamp exists for pipeline-computed valuations). Omit to use the latest knowable inputs.
`fcf_source`	"trend" \| "three_statement"	optional	"trend" (default): compound fcf_base by stage1_growth_rate every year (unchanged original behavior). "three_statement": derive the FCF stream from a full linked 3-statement projection instead — see the tool description for details.Default: `"trend"`
`three_statement_assumptions`	object	optional	Only used when fcf_source is "three_statement". Overrides for the underlying projection; unset fields use project_three_statement's defaults.

Output Fields

tickerresult

Example Response

Illustrative

response.jsonjson

{  "ticker": "AAPL",  "result": 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

CategoryValuation

PIT-safeYes

Min planBenchmark

Inputs10 (2 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.