@pipeworx/edgar

Connect: https://gateway.pipeworx.io/edgar/mcp · Install: one-click buttons

Tools: 5

The Securities and Exchange Commission’s filings database. Every public company in the US files here, every filing is timestamped and immutable, and every disclosure (revenue, debt, risk factors, executive compensation, M&A activity, insider trading) is structured for machine retrieval. Free and authoritative.

Why this matters for AI agents

If your agent is answering anything about a US public company — financials, legal exposure, IP, executive turnover, recent material events — the answer is in EDGAR. The data is structured (XBRL), so you don’t have to parse PDFs.

The two key flows:

1. Filings flow. “Show me Apple’s recent 10-Q.” → edgar_ticker_to_cik("AAPL") → edgar_company_filings(cik) → list of filings with accession numbers, form types, filing dates.

2. Concepts flow. “What was Apple’s revenue trend the last 4 quarters?” → edgar_company_concept(cik, "Revenues") → time series of XBRL-tagged values across periods.

Both are usually preceded by edgar_ticker_to_cik or resolve_entity({type: "company", value: "AAPL"}) to get the canonical 10-digit CIK.

Auth

None. SEC EDGAR is a free, public, no-auth service. Pipeworx forwards a polite User-Agent header to comply with SEC’s API guidelines.

Citable URIs

pipeworx://edgar/company/{cik}/filings
pipeworx://edgar/company/{cik}/facts

Embed in your output. Stable across reorganizations — companies rebrand, but their CIK doesn’t change.

Form types worth knowing

For insider trades specifically, see the dedicated insider-trading pack — it surfaces Form 4 / 13D / 13G changes with cleaner schemas.

Common pitfalls

• Concept name drift. SEC filers occasionally change the XBRL concept they tag for revenue. The default Revenues concept may be stale for newer fiscal years; try RevenueFromContractWithCustomerExcludingAssessedTax as a fallback.
• Period mismatches. Fiscal years end at different times across companies (Apple = Sept, Microsoft = June, Google = Dec). When comparing, always disclose the period.
• CIK formatting. Some endpoints want zero-padded 10-digit (0000320193), some want unpadded (320193). Pipeworx accepts either; the cik_padded field in edgar_ticker_to_cik is the canonical form for resource URIs.
• Real-time-ish, not real-time. Filings appear on EDGAR within minutes of submission, but Pipeworx caches results. For breaking-news-grade timeliness, set Cache-Control: no-cache (anonymous limit applies) or check the _meta.cache.fresh_until field.
• Concept availability differs. Smaller filers tag fewer XBRL concepts than large ones. edgar_company_concept may return empty arrays for valid concepts that the company simply doesn’t report. Use edgar_company_facts to see which concepts a company DOES report.

Tools

• edgar_search_filings — Search SEC filings by keyword, company name, or topic. Filter by form type (e.g., ‘10-K’, ‘8-K’) and date range. Returns filing metadata, accession numbers, and document links.
• edgar_company_filings — Get recent SEC filings for a company by ticker (e.g., ‘AAPL’) or CIK number. Filter by form type (e.g., ‘10-Q’, ‘10-K’). Returns filing dates, types, and accession numbers.
• edgar_company_facts — Get structured financial data for a company by CIK number. Returns revenue, net income, assets, liabilities, and other key metrics with annual and historical values.
• edgar_company_concept — Track a specific financial metric over time for a company by CIK number (e.g., revenue, net income). Returns all reported values with dates and filing types.
• edgar_ticker_to_cik — Convert a stock ticker (e.g., ‘TSLA’) to its CIK number. Returns the CIK identifier and company name for use in other edgar tools.