MCP Server live — AI agents can now query 105M+ SEC facts. Connect your agent →
ValueinValuein
MCP Tools/get_peer_comparables
Analysis

Get Peer Comparables

get_peer_comparables
sp500
full

Cross-sectional peer comparison using pipeline-computed financial ratios. Returns the subject company alongside sector peers with key ratios side-by-side: gross margin, operating margin, ROE, debt-to-equity, FCF margin. Use for relative valuation and competitive analysis.

Example Call

# 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", peer_count=5)

Inputs

ParameterTypeRequiredDescription
tickerstring
required
The primary company to compare
peer_countintegeroptionalNumber of peers to include (1–20). Defaults to 5.

Output Fields

tickerciknamesectorindustryis_subjectratios

Example Response

[
  {
    "ticker": "AAPL",
    "cik": "0000320193",
    "name": "Apple Inc.",
    "sector": "Technology",
    "industry": "Consumer Electronics",
    "is_subject": true,
    "ratios": 0.2543
  }
]

Returns NVIDIA alongside AMD, Intel, Qualcomm, Broadcom, and Texas Instruments with ratio comparison.

Notes

Peers are selected by sector and industry from ratio.parquet. Not PIT-safe — uses latest available ratios for all companies.