# Edgar & Edgarette · POPS4 filing boards and actuarial company cards

> Free, no login. SEC filings the day they are filed, sorted onto nine boards, and an actuarial reading of any
> SEC filer’s audited figures. Every number links to its SEC source. Data free to use with credit to POPS4 (CC BY 4.0).

## MCP (JSON-RPC over HTTP POST, no auth)
- Endpoint: https://www.pops4.com/boards/mcp
- get_breaches … get_auditor_watch: The nine boards: rows of SEC filings with company facts, one tool per board. Argument: limit (default 50, max 200).
- get_company_performance: Edgarette’s card for any SEC filer. Argument: company (name, ticker or CIK). Returns schema pops4.edgarette.card/1.
- watch_company: Ask Edgar to email a person the day a company files. Arguments: company, email, optional cik and board. One-click stop link in every note.
- price_program: Price the program a filing usually calls for, live from the POPS4 catalogue at wholesale. Arguments: board, attendees, tier.

## HTTP
- https://www.pops4.com/boards/{board}.json | .csv | /feed.xml | /embed : Each board as JSON, CSV, RSS, or an embeddable table.
- https://www.pops4.com/boards/ask.json?q={name|ticker|CIK} : Edgarette’s card as JSON (same as get_company_performance).
- https://www.pops4.com/boards/scorecard.json : The Forecast Registry: every range logged, its hash, and how it scored.
- https://www.pops4.com/boards/report : The weekly performance report (HTML).
- https://www.pops4.com/boards/fields.json : What every board field means.
- https://www.pops4.com/boards/all.json : Counts across all boards.

## Card schema pops4.edgarette.card/1
- schema: “pops4.edgarette.card/1”. Field names stay stable within a version.
- card.exposure: fiscalYearEnd, revenue, totalDebt (including the part due within a year), cash, all at the same fiscal year-end.
- card.experience: revenueGrowth1y, revenueGrowthPerYear, operatingMargin, operatingMarginPrior, netMargin, freeCashFlow.
- card.peers: Medians of SEC filers with $50M+ revenue in the narrowest industry (SIC) group with at least 8 of them: opMargin, growth, netMargin, each [median, count].
- card.credibility: auditedYears and a plain weight (little, moderate, reasonable), in the sense of ASOP No. 25.
- card.range: An 80% range for next fiscal year’s revenue (method v2), its baseline, the size band and number of company-years it was set from, and its track record (backtest and registry).
- card.caution: The known limits of the data (ASOP No. 41 and No. 23).
- card.sources: Links to the SEC data behind the card.

## Method
- Sources: SEC XBRL company facts, SEC submissions, SEC company tickers, SEC XBRL frames. No licensed data.
- Order of the card follows actuarial reporting (ASOP No. 41, 25, 23): exposure, experience, credibility, range, caution.
- Range v2: baseline = revenue x (1 + mean of one-year and three-year pace); 80% range from the 10th-90th percentile of how 7,847 SEC company-years ($50M+ revenue, 2022-2024) actually turned out, by size band.
- Forecast Registry: each range is logged once per company-year with a SHA-256 fingerprint and scored when the next 10-K arrives. Misses are published with hits: https://www.pops4.com/boards/scorecard

## Limits
- Annual audited figures only (10-K). No quarterly figures yet, and no share prices.
- Banks and insurers report revenue differently; their cards can be thin, and say so rather than guess.
- Figures are as filed; restatements, acquisitions and changes of fiscal year can move them.
- The range is calibrated, not a forecast: about 8 in 10 outcomes should land inside it, and the scorecard checks in public whether they do.
- Reporting, not investment advice. No price targets, no buy or sell views.

## Other POPS4 endpoints
- Product catalogue MCP (70,000+ products): https://mcp.pops4.com/mcp
- Developer page: https://www.pops4.com/boards/developers

Maintained by Jenny Huang Goodman MPA MSc MHSA, Principal · Hako Shikin LLC, Virginia Beach · jenny@pops4.com