FilingFirehose

jaablon/filingfirehose-python

Connects Claude to the FilingFirehose SEC EDGAR API for body-text-parsed filings. Exposes operations to fetch recent 8-K filings with buried-event detection (flagging when filer-reported items don't match body language), activist-tagged Schedule 13D/G filings searchable by investor name, and ATM offerings extracted from S-3 prospectus supplements. The free tier returns 72 hours of data; paid keys unlock historical search back to 2026. Reach for this when you need to catch unreported cyber incidents, officer departures, or material agreements that companies bury in generic 8.01 "other events" filings, or when tracking activist positions and shelf offerings programmatically.

tools: 4
transport: HTTP
last updated: May 10, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://filingfirehose.com/mcp --name firehose

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http firehose https://filingfirehose.com/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 4 tools

Verified live against the running server on Nov 6, 2026.

search_8k_filingsSearch 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...3 params

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...

Parameters* required

itemsvalue

limitinteger

default: 25

suspected_buried_onlyboolean

default: false

search_13d_filingsSearch 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...5 params

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...

Parameters* required

activistvalue

include_amendmentsboolean

default: true

include_passive_13gboolean

default: false

limitinteger

default: 25

min_percentvalue

search_atm_offeringsSearch 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: 'C...3 params

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: 'C...

Parameters* required

limitinteger

default: 25

min_shelf_million_usdvalue

sales_agentvalue

get_filingFetch 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...1 params

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...

Parameters* required

accession_number*string

Readme

filing-firehose

Python client for the FilingFirehose SEC EDGAR API — body-text-parsed 8-Ks (with buried-event detection), activist-tagged Schedule 13D/G filings, and ATM offerings extracted from S-3 / 424B5 prospectus supplements.

Install

pip install filing-firehose

Quick start

The free public tier returns the last 72 hours of filings — no API key required:

from filing_firehose import FilingFirehose

ff = FilingFirehose()

# Recent 8-Ks where the body language flags items the filer didn't report
buried = ff.recent_8k(suspected_buried_only=True, limit=10)
for f in buried:
    print(f"{f.company_name}: filer reported {f.filer_reported_items}, "
          f"body suggests {f.suspected_buried_events}")

# Recent activist 13D / 13G filings
for f in ff.recent_13d(activist="Saba"):
    print(f"{f.company_name} — {f.percent_of_class}% by {f.activist_filers}")

# Recent ATM offerings with shelf size > $50M
for f in ff.recent_atm(min_shelf_million_usd=50):
    print(f"{f.company_name}: ${f.shelf_size_million_usd:.1f}M via {f.sales_agents}")

View the full README on GitHub

Details

Repository: github.com/jaablon/filingfirehose-python
Website: filingfirehose.com
Transport: HTTP
Registry: MCP registry, active
Tools verified: Nov 6, 2026