What inputs does get_valuation_metrics accept?

ticker (string, required): Stock ticker symbol, e.g. AAPL, MSFT — or a CIK (SEC identifier), e.g. '0000320193'. fiscal_year (integer, optional): Fiscal year (YYYY). Omit to return most recent periods. period ("annual" | "quarterly", optional, default "annual"): Filing period granularity. Annual uses 10-K; quarterly uses 10-Q. as_of_date (string, optional): Point-in-time date (YYYY-MM-DD). Only returns data with accepted_at on or before this date. Eliminates look-ahead bias for backtesting. limit (integer, optional, default 5): Maximum number of periods to return (1–40). Defaults to 5.

Which Valuein plans include get_valuation_metrics?

Available on every plan, including the free tier with no account. Point-in-time safe via as_of_date filtering.

Valuation

PIT-safe

Valuation Metrics

get_valuation_metrics

Sample and above

Get what a US public company is TRADING AT, plus two parameter-free reference points. This is NOT an opinion of intrinsic worth — for that, call `compute_dcf` with assumptions you state explicitly, and present the result as a scenario, never as "the" fair value. Returns per-pe...

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

Direct tool call:get_valuation_metrics(ticker="AAPL", limit=3)

Try it now

No token required

Paste this in your terminal — the free tier returns real sample data without authentication.

try-it.shbash

# No auth required — the Sample tier covers a large-cap US benchmark universe with a 5-year window.# Add -H "Authorization: Bearer $VALUEIN_TOKEN" for the full universe and history.curl -X POST https://mcp.valuein.biz/mcp \    -H "Content-Type: application/json" \    -H "Accept: application/json, text/event-stream" \    -d '{        "jsonrpc": "2.0",        "id": 1,        "method": "tools/call",        "params": {          "name": "get_valuation_metrics",          "arguments": {            "ticker": "AAPL",            "limit": 3          }        }      }'

Inputs

Parameter	Type	Required	Description
`ticker`	string	required	Stock ticker symbol, e.g. AAPL, MSFT — or a CIK (SEC identifier), e.g. '0000320193'.
`fiscal_year`	integer	optional	Fiscal year (YYYY). Omit to return most recent periods.
`period`	"annual" \| "quarterly"	optional	Filing period granularity. Annual uses 10-K; quarterly uses 10-Q.Default: `"annual"`
`as_of_date`	string	optional	Point-in-time date (YYYY-MM-DD). Only returns data with accepted_at on or before this date. Eliminates look-ahead bias for backtesting.
`limit`	integer	optional	Maximum number of periods to return (1–40). Defaults to 5.Default: `5`

Output Fields

tickerperiodas_of_dateperiods_returneddata

Example Response

Illustrative

response.jsonjson

[  {    "ticker": "AAPL",    "period": null,    "as_of_date": null,    "periods_returned": null,    "data": null  }]

Shape only — field names match the live schema; values are placeholders, not real filings. Returns Apple's last 3 annual periods with observed price multiples (P/E, P/B, EV/EBITDA, dividend yield, market cap), two parameter-free reference points (graham_number, ncav_per_share), and profitability ratios. No intrinsic value — call compute_dcf with your own assumptions for that.