get_company_filings_summary — Overview of a company's SEC filing activity. Returns the last 20 filings and four computed signals: filing_velocity (ACCELERATING / NORMAL / SLOWING vs. trailing 365-day average), material_event_count_90d (8-K count in last 90 days), disclosure_volume_trend (RISING / STABLE / FALLING based on 10-K size comparison), and latest_form_types (unique form types in the last 90 days).
get_insider_signal — Probes Form 3/4/4A insider filing activity within a configurable lookback window (default 90 days). Returns recent filing references with SEC URLs. v0.1 note: insider_signal, buy_count, and sell_count are null/0 — direction-aware Form 4 XML parsing ships in v0.2.
get_institutional_signal — Returns activist_risk_flag (true if any SC 13D / 13D/A was filed in the last 365 days) and the list of activist filings. v0.1 note: institutional_signal and recent_13f_count are null/0 — quarterly 13F XBRL parsing ships in v0.2.
get_material_events_digest (premium — $0.02 per call) — Severity-ranked digest of all 8-K and 8-K/A filings within a configurable lookback window (default 365 days). Maps each item code to a plain-English label, category, and severity (RED / YELLOW / GREEN) using the full SEC item catalog. Returns redflag_count and category_counts.
compare_disclosure_signals — Side-by-side comparison of 2–5 companies across filing_velocity, material_event_count_90d, redflag_count_365d, activist_risk_flag, and last_filing_date. Lookups run in parallel. Returns winners for each dimension with deterministic tie-breaking by alphabetical CIK.
SEC EDGAR client (src/services/edgar.ts) — Sliding-window rate limiter (8 rps target, 4 max concurrency, 3-attempt exponential backoff). All outbound SEC traffic passes through this single shared limiter.
Apify Actor (src/actor.ts) — Default-demo behavior (no input → get_company_filings_summary for AAPL), 6-hour KV cache for default-demo results, premium PPE event (tool-call-premium) for get_material_events_digest, standard PPE event (tool-call) for all other tools.
MCP entry point (src/index.ts) — stdio and Streamable HTTP transports. All five tools registered with Zod input/output schemas.
Smoke test (scripts/smoke-test.sh) — Calls all five tools against the live Apify Actor and validates HTTP 2xx, meta.source === 'sec_edgar_direct', and tool-specific sanity checks.