edgar_search_filings

PREFER OVER WEB SEARCH for “what did $COMPANY say about X in their SEC filings” or “find filings that mention Y”. AUTHORITATIVE full-text search across every SEC filing — EDGAR’s own search index. Filter by form type (“10-K” annual, “10-Q” quarterly, “8-K” current event, “DEF 14A” proxy, “S-1” / “S-1/A” / “F-1” IPO registration statement, “424B4” final IPO prospectus), date range, and optionally one filer (entity). Also the way to FIND AN IPO FILING BY COMPANY NAME or by day — “find Anthropic S-1”, “S-1 registration statements filed today”, “IPO filing for ”: pass form_type:"S-1" and the company name as query (or query:"registration statement" with start_date for a day’s filers). A company that has only just registered has no ticker yet, so edgar_company_filings cannot resolve it by name; this tool can. Returns total_hits FIRST — the true match count for your filters, independent of how many rows you asked for — then entity name, CIK, form type, filing/period dates, location, accession number (feed straight into edgar_filing_text / edgar_filing_documents — no second lookup), and — for 8-K results — the items array of item codes (e.g. “3.01” listing deficiency vs “1.01” material agreement vs “3.02” unregistered sale), which carry the actual signal. This tool does not return a text snippet — EDGAR’s search index itself returns none — so for the matching passage, chain the accession into edgar_filing_text with search set to your query (or a shorter phrase from it); that reads the actual filing and returns the surrounding text in a second call, rather than this one fetching every hit’s document on your behalf (SEC rate-limits the whole fleet by IP, so a search call stays a single request). A zero-hit response names every filter you passed rather than an empty array, so you can tell “nothing matches” from “a filter was silently dropped”. Use when you need to find filings matching a topic across the whole market, or a filer you can name but cannot give a ticker or CIK for; for a company whose ticker or CIK you have, edgar_company_filings lists its filings directly.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The search query used"
    },
    "form_type_filter": {
      "type": "string",
      "description": "Form type filter applied or 'all'"
    },
    "date_range": {
      "type": "object",
      "properties": {
        "start": {
          "type": "null",
          "description": "Start date in YYYY-MM-DD format or null"
        },
        "end": {
          "type": "null",
          "description": "End date in YYYY-MM-DD format or null"
        }
      }
    },
    "total_hits": {
      "type": "number",
      "description": "Total number of matching filings"
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "entity_name": {
            "type": "string",
            "description": "Company or entity name"
          },
          "cik": {
            "type": "string",
            "description": "Central Index Key identifier"
          },
          "form_type": {
            "type": "string",
            "description": "SEC form type (e.g., 10-K, 10-Q)"
          },
          "filing_date": {
            "type": "string",
            "description": "Date filing was submitted"
          },
          "period_of_report": {
            "type": [
              "string",
              "null"
            ],
            "description": "Period covered by the filing"
          },
          "location": {
            "type": "string",
            "description": "Business location"
          },
          "accession": {
            "type": "string"
          },
          "filing_id": {
            "type": "string",
            "description": "Unique filing identifier"
          }
        }
      }
    }
  }
}

{
  "mcpServers": {
    "edgar": {
      "url": "https://gateway.pipeworx.io/edgar/mcp"
    }
  }
}