get_valuation_metrics

io.github.valuein/mcp-sec-edgar · Verify this server

Get comprehensive valuation and profitability metrics for a US public company. Returns per-period data combining computed ratios (gross_margin, operating_margin, net_margin, ROE, ROA, ROIC, debt_to_equity, FCF, FCF margin), price-derived valuation_multiples (current_price, market_cap, pe_ratio, pb_ratio, ev_ebitda, dividend_yield), and optional pre-computed DCF model inputs (WACC, fcf_base_per_share, stage1_growth_rate, terminal_growth_rate, dcf_value_per_share, ddm_value_per_share). Profitability/cash-flow/leverage fields come from fact.parquet (PIT-safe via accepted_at). valuation_multiples are LIVE (schema 2.18.0): they come from ratio.parquet's `valuation` category + stock_price.parquet period-end close (per-period current_price for every fiscal year), derived from EOD prices period-end-aligned. Each multiple is a `{value, unit}` pair (unit varies: x / USD / percent); a null value carries a `null_reasons[field]` PRICE_NOT_AVAILABLE code (no period-end-aligned close). DCF/DDM fields come from valuation.parquet (pipeline-computed, recomputed each run — NOT strictly PIT-safe) and are commonly null (newer tickers, transition periods, or before the valuation pipeline runs). Each null carries a `null_reasons[field]` code — ALWAYS check it before assuming zero (null != 0). For strict-PIT DCF, use the SDK or compute from `get_company_fundamentals`. Use this *instead of* `get_financial_ratios` when DCF/intrinsic value or price multiples matter; use `get_financial_ratios` when you only need the raw ratio table. Available on all plans.