get_pit_universe

io.github.valuein/mcp-sec-edgar · Verify this server

Use this tool to answer questions about historical index membership — e.g. "Was Company X in the S&P 500 on date Y?" or "Which companies were in the Russell 2000 on 2010-01-01?" Use this INSTEAD OF `search_companies` when the question involves a specific historical date or whether a company was an index member in the past — `search_companies` only returns current membership and cannot answer historical questions. Returns a survivorship-free universe valid on a given as_of_date (only companies that existed and were members on that exact date — no hindsight). Supports SP500, RUSSELL1000, RUSSELL2000, RUSSELL3000 via index_membership.parquet (accurate join/leave dates, [) interval semantics). To check one company, pass its ticker + the target date: present = was a member, absent = was not. Returns per company: CIK, ticker, name, sector, industry, SIC code, and per-row confidence (high/medium/low). `_meta.pit_safe` is true only when every matched row is high-confidence — treat low-confidence rows with caution. `sector` is SIC-derived (GICS-aligned, not licensed GICS) — a screening bucket, not an authoritative label. Use as the first step of a quantitative backtest before `get_compute_ready_stream`. Returns an empty array (with error detail) if the date is out of range or has no coverage. Available on every plan — sample returns the subset covered by the sample bucket.