What inputs does get_peer_comparables accept?

ticker (string, required): The primary company to compare peer_count (integer, optional): Number of peers to include (1–20). Defaults to 5.

Which Valuein plans include get_peer_comparables?

Available on: sample, sp500, full. Not point-in-time safe.

MCP Tools/get_peer_comparables

Analysis

Peer Comparables

get_peer_comparables

sample

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)

Try it now

No token required

Paste this in your terminal — the sample tier returns real S&P500 data without authentication.

# No auth required — sample tier covers S&P500 with a 5-year window.
# Add an Authorization: Bearer header for full universe and history.
$ curl -X POST https://mcp.valuein.biz/mcp \
    -H "Content-Type: application/json" \
    -d '{
        "jsonrpc": "2.0",
        "id": 1,
        "method": "tools/call",
        "params": {
          "name": "get_peer_comparables",
          "arguments": {
            "ticker": "AAPL",
            "peer_count": 3
          }
        }
      }'

Inputs

Parameter	Type	Required	Description
`ticker`	string	required	The primary company to compare
`peer_count`	integer	optional	Number 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
  }
]