MCP.so
Sign In
F

FilingFirehose

@jaablon

About FilingFirehose

SEC EDGAR filings parsed and exposed via MCP — body-text-classified 8-Ks (7.3% of recent Item 8.01 filings have buried 1.05/5.02 events the filer didn't report), Schedule 13D/G with 21+ activist filers auto-tagged, S-3/424B5 ATM offering detection. Free public tier covers past 72

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "filingfirehose": {
      "url": "https://filingfirehose.com/mcp"
    }
  }
}

Tools

4

Search recent SEC 8-K filings (current report) from the past 72 hours. Args: items: Comma-separated 8-K item codes to filter on. Examples: '1.05' (cybersecurity), '5.02' (officer departure), '8.01' (other events), '1.01' (material agreement). Leave None for all 8-Ks. suspected_buried_only: If True, return only filings where our body-text classifier flagged a suspected misclassification — i.e. cyber language under Item 8.01 that should have been 1.05, officer-departure language under 8.01 that should have been 5.02. limit: Max results (1-50, default 25). Returns: JSON-formatted list of filings. Each includes: accession_number, company_name, filed_at, filer_reported_items, detected_items, discrepancy_items (in body but not reported), and suspected_buried_events (map of reported→suspected).

Search recent SEC Schedule 13D / 13G filings from the past 72 hours. Args: activist: Filter to filings tagged with this activist filer name. Substring match, case-insensitive. Examples: 'Saba', 'Starboard', 'Icahn', 'Elliott', 'Pershing'. min_percent: Minimum percent of class disclosed. include_amendments: Include 13D/A and 13G/A amendments. Default True. include_passive_13g: Include passive Schedule 13G filings. Default False (only active 13D / 13D/A returned). limit: Max results (1-50, default 25). Returns: JSON list of filings with cusip, percent_of_class, aggregate_amount, activist_filers, and an Item 4 purpose excerpt.

Search recent SEC at-the-market (ATM) equity offerings from the past 72 hours. Pulls from S-3 / 424B5 family filings where our parser flagged ATM-offering indicators in the body language. Args: sales_agent: Filter by sales agent name (substring, case-insensitive). Examples: 'Cantor Fitzgerald', 'Jefferies', 'Roth Capital', 'H.C. Wainwright'. min_shelf_million_usd: Minimum shelf size in millions USD. limit: Max results (1-50, default 25). Returns: JSON list with shelf_size_usd, is_atm, sales_agents, use_of_proceeds_excerpt.

Fetch one filing by SEC accession number, regardless of recency. Useful when an agent has an accession number from a citation or earlier tool call and needs the parsed details. Args: accession_number: SEC accession in 'XXXXXXXXXX-YY-NNNNNN' format. Returns: JSON for the filing if found in our archive, or {"found": false}.

Overview

What is FilingFirehose?

FilingFirehose is a Python client for the FilingFirehose SEC EDGAR API that delivers body-text–parsed 8-K filings with buried-event detection, activist-tagged Schedule 13D/G filings, and ATM offering data extracted from S‑3 / 424B5 prospectus supplements. It is built for financial analysts, quantitative researchers, and compliance teams who need structured, classified SEC data.

How to use FilingFirehose?

Install via pip install filing-firehose. Instantiate FilingFirehose() without an API key for the free tier (last 72 hours) or with an api_key for the full historical archive. Use methods such as recent_8k(), recent_13d(), and recent_atm() with optional filters.

Comments

More Productivity MCP servers