What inputs does get_peer_comparables accept?

ticker (string, required): Subject company ticker or CIK, e.g. AAPL or '0000320193'. Peers are auto-selected by SIC code. categories (array, optional, default ["profitability","valuation","leverage"]): Ratio categories to include in the comparison. Defaults to profitability, valuation, and leverage. as_of_date (string, optional): Historical date (canonical cross-tool date param). Peers are the companies listed on this date, including ones delisted since, ranked by S&P 500 membership on this date. Figures are point-in-time by SEC acceptance time when the ratio data carries it (_meta.pit_safe=true), else limited to periods ending on or before this date (_meta.pit_safe=false). period_end_before (string, optional): Alias of as_of_date (as_of_date preferred — the canonical name). Only include ratios with period_end on or before this date. limit (integer, optional, default 5): Maximum number of peers to return alongside the subject company (1–10). Defaults to 5. peer_universe ("sic" | "sp500_sector", optional): Where peers come from: 'sic' (default) matches SIC industry codes; 'sp500_sector' uses S&P 500 members in the subject's own sector, largest market cap first.

Which Valuein plans include get_peer_comparables?

Available on every plan, including the free tier with no account. Not point-in-time safe.

Analysis

Peer Comparables

get_peer_comparables

Sample and above

Get ratio-based peer comparison for a company and its closest competitors. Peers are selected by matching 2-digit SIC industry code. Returns pipeline-computed ratios from up to 10 peers alongside the subject company for direct benchmarking. Ratio categories: profitability, liq...

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

Direct tool call:get_peer_comparables(ticker="NVDA", limit=5)

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_peer_comparables",          "arguments": {            "ticker": "AAPL",            "limit": 3          }        }      }'

Inputs

Parameter	Type	Required	Description
`ticker`	string	required	Subject company ticker or CIK, e.g. AAPL or '0000320193'. Peers are auto-selected by SIC code.
`categories`	array	optional	Ratio categories to include in the comparison. Defaults to profitability, valuation, and leverage.Default: `["profitability","valuation","leverage"]`
`as_of_date`	string	optional	Historical date (canonical cross-tool date param). Peers are the companies listed on this date, including ones delisted since, ranked by S&P 500 membership on this date. Figures are point-in-time by SEC acceptance time when the ratio data carries it (_meta.pit_safe=true), else limited to periods ending on or before this date (_meta.pit_safe=false).
`period_end_before`	string	optional	Alias of as_of_date (as_of_date preferred — the canonical name). Only include ratios with period_end on or before this date.
`limit`	integer	optional	Maximum number of peers to return alongside the subject company (1–10). Defaults to 5.Default: `5`
`peer_universe`	"sic" \| "sp500_sector"	optional	Where peers come from: 'sic' (default) matches SIC industry codes; 'sp500_sector' uses S&P 500 members in the subject's own sector, largest market cap first.

Output Fields

subjectcategoriesas_of_dateperiod_end_beforepeers_returnedpeers_omitted_no_datanotedatasubject_ratioslineage

Example Response

Illustrative

response.jsonjson

[  {    "subject": null,    "categories": null,    "as_of_date": null,    "period_end_before": null,    "peers_returned": null,    "peers_omitted_no_data": null,    "note": null,    "data": null  }]

Shape only — field names match the live schema; values are placeholders, not real filings. Returns NVIDIA alongside AMD, Intel, Qualcomm, Broadcom, and Texas Instruments with ratio comparison.