What inputs does screen_universe accept?

ticker (string, optional): If provided, returns only this company's factor scores (single-entity mode). sector (string, optional): Filter to a sector (case-insensitive partial match). sort_by (string, optional): Rank to sort by — the composite rank (default) or an individual factor rank. limit (integer, optional): Results to return (1–100). Defaults to 25.

Which Valuein plans include screen_universe?

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

Screening

Screen Universe by Factor Scores

screen_universe

Free

Pro · Institutional

Cross-sectional factor screening using pipeline-computed percentile ranks. Returns companies ranked by a composite score (or a single company's scores in single-entity mode). Supports sector filtering. Ranks are percentiles where 1.0 = best in universe.

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(    "screen_universe",    arguments={})print(result)

Direct tool call:screen_universe(sector="Technology", sort_by="composite_rank", limit=10)

Try it now

No token required

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

try-it.shbash

# 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": "screen_universe",          "arguments": {            "limit": 3          }        }      }'

Inputs

Parameter	Type	Required	Description
`ticker`	string	optional	If provided, returns only this company's factor scores (single-entity mode).
`sector`	string	optional	Filter to a sector (case-insensitive partial match).
`sort_by`	string	optional	Rank to sort by — the composite rank (default) or an individual factor rank.
`limit`	integer	optional	Results to return (1–100). Defaults to 25.

Output Fields

symbolnamesectorcomposite_rank

Example Response

Illustrative

response.jsonjson

[  {    "symbol": "AAPL",    "name": "Apple Inc.",    "sector": "Technology",    "composite_rank": 0.92  }]

Shape only — field names match the live schema; values are placeholders, not real filings. Returns the top 10 Technology companies by composite factor rank.