Sec Beneficial Ownership MCP server

@pipeworx/sec-beneficial-ownership

SEC Schedule 13D / 13G beneficial-ownership filings — who holds 5%+ of a public company's stock, how (sole vs. shared voting/dispositive power), and — for 13D — why (Item 4 "Purpose of Transaction", the activist-investor signal). Parses the structured XML SEC has required since its 2024 rule, and falls back honestly (structured: false) on older plain-text filings instead of returning nothing.

Part of Pipeworx — an MCP gateway connecting AI agents to 1721+ live data sources. This is an independent, unofficial integration — not affiliated with, endorsed by, or published by the upstream provider.

Tools

Schedule 13D/13G filings (and amendments), newest first. Each row flags whether it is structured XML or pre-2024 plain text.

• sec13dfilings(tickerorcik, form_type?, limit?) — list an issuer's

reporting owner with percent of class, sole/shared voting power, sole/shared dispositive power, aggregate shares owned; for 13D, also Item 4's purpose text. Falls back to bounded plain text for pre-rule filings.

• sec13dfiling(tickerorcik, accession_number) — parse one filing: every

or 13G/A, find the same reporting group's prior filing in the chain and diff ownership %, voting/dispositive power (per owner), and (13D) whether the Item 4 purpose text changed.

• sec13damendmentdiff(tickerorcik, accessionnumber) — given one 13D/A

Auth

Keyless. SEC EDGAR is free, public, and requires no API key — only a descriptive User-Agent, which this pack sends on every request per SEC's developer guidelines.

Data sources

index (form type, accession number, filing date, primary document name). Shared pattern with mcps/edgar.

• https://data.sec.gov/submissions/CIK##########.json — per-issuer filing

the filing's structured XML, for filings on or after SEC's 2024 structured-data rule (SCHEDULE 13D / SCHEDULE 13G form types).

• https://www.sec.gov/Archives/edgar/data/{cik}/{accession}/primary_doc.xml —

the filing's plain HTML/text document, for pre-rule filings (SC 13D / SC 13G form types).

• https://www.sec.gov/Archives/edgar/data/{cik}/{accession}/{primary_document} —

CIK resolution, via the shared resolveSecEntity helper (also used by mcps/edgar) — one resolver for every SEC-keyed pack rather than a second implementation here.

• https://www.sec.gov/files/company_tickers.json — ticker/company-name to

Traps worth knowing

Shortened. The full README is on GitHub.