What inputs does project_three_statement accept?

ticker (string, required): Stock ticker symbol, e.g. AAPL, MSFT, BRK.B. years (integer, optional, default 5): Projection horizon in years (1-15). Defaults to 5. revenue_growth_rate (number, required): Flat annual revenue growth rate applied every year (e.g. 0.08 = 8%/yr). interest_rate_on_debt (number, optional, default 0.06): Annual interest rate on beginning-of-period debt. Assumption — default 0.06. tax_rate (number, optional, default 0.21): Effective tax rate on positive pretax income. Default 0.21 (US statutory). gross_margin_pct_override (number, optional): Override the seed period's gross margin (held flat across all years). Leave unset to use the historical ratio. operating_margin_pct_override (number, optional): Override the seed period's operating margin. Leave unset to use the historical ratio. capex_pct_of_revenue_override (number, optional): Override the seed period's capex-as-%-of-revenue ratio. Leave unset to use the historical ratio. cash_sweep_pct (number, optional, default 0): Fraction (0-1) of each year's free cash flow swept to debt paydown. Default 0 (going-concern; use ~1.0 for an LBO-style paydown). dividend_payout_pct (number, optional, default 0): Fraction (0-1) of net income paid out as dividends each year. Default 0. new_debt_draw_year1 (number, optional, default 0): New debt drawn at year 1 only (absolute USD) — e.g. acquisition financing. Default 0. new_equity_draw_year1 (number, optional, default 0): New equity contributed at year 1 only (absolute USD) — hits cash + equity symmetrically. Default 0. as_of_date (string, optional): Point-in-time cutoff (YYYY-MM-DD) for the seed period. Omit to use the latest knowable annual period.

Which Valuein plans include project_three_statement?

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

Discovery

Project Linked Three-Statement Model

project_three_statement

Benchmark and above

Linked forward Income Statement / Balance Sheet / Cash Flow projection, seeded from the company's latest historical annual period. The balance sheet ties out (assets == liabilities + equity) EVERY projected year by algebraic construction — each year's `tie_out_ok` field is a l...

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

Direct tool call:project_three_statement(...)

Inputs

Parameter	Type	Required	Description
`ticker`	string	required	Stock ticker symbol, e.g. AAPL, MSFT, BRK.B.
`years`	integer	optional	Projection horizon in years (1-15). Defaults to 5.Default: `5`
`revenue_growth_rate`	number	required	Flat annual revenue growth rate applied every year (e.g. 0.08 = 8%/yr).
`interest_rate_on_debt`	number	optional	Annual interest rate on beginning-of-period debt. Assumption — default 0.06.Default: `0.06`
`tax_rate`	number	optional	Effective tax rate on positive pretax income. Default 0.21 (US statutory).Default: `0.21`
`gross_margin_pct_override`	number	optional	Override the seed period's gross margin (held flat across all years). Leave unset to use the historical ratio.
`operating_margin_pct_override`	number	optional	Override the seed period's operating margin. Leave unset to use the historical ratio.
`capex_pct_of_revenue_override`	number	optional	Override the seed period's capex-as-%-of-revenue ratio. Leave unset to use the historical ratio.
`cash_sweep_pct`	number	optional	Fraction (0-1) of each year's free cash flow swept to debt paydown. Default 0 (going-concern; use ~1.0 for an LBO-style paydown).Default: `0`
`dividend_payout_pct`	number	optional	Fraction (0-1) of net income paid out as dividends each year. Default 0.Default: `0`
`new_debt_draw_year1`	number	optional	New debt drawn at year 1 only (absolute USD) — e.g. acquisition financing. Default 0.Default: `0`
`new_equity_draw_year1`	number	optional	New equity contributed at year 1 only (absolute USD) — hits cash + equity symmetrically. Default 0.Default: `0`
`as_of_date`	string	optional	Point-in-time cutoff (YYYY-MM-DD) for the seed period. Omit to use the latest knowable annual period.

Output Fields

tickerseed_period_endresult

Example Response

Illustrative

response.jsonjson

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

CategoryDiscovery

PIT-safeNo

Min planBenchmark

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