`edgar_search_filings`

Pack: edgar · Endpoint: https://gateway.pipeworx.io/edgar/mcp

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) and date range. Returns 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. Use when you need to find filings matching a topic across the whole market, not for a specific company (for that use edgar_company_filings).

Parameters

Name	Type	Required	Description
`query`	string	yes	Search query (e.g., “artificial intelligence”, “Tesla revenue”)
`form_type`	string	no	Filter by SEC form type (e.g., “10-K”, “10-Q”, “8-K”, “DEF 14A”). Omit for all types.
`start_date`	string	no	Start date in YYYY-MM-DD format (e.g., “2024-01-01”)
`end_date`	string	no	End date in YYYY-MM-DD format (e.g., “2024-12-31”)
`limit`	number	no	Number of results to return (1-40, default 10)

Example call

Arguments

{
  "query": "artificial intelligence",
  "form_type": "10-K",
  "start_date": "2024-01-01",
  "end_date": "2024-12-31",
  "limit": 20
}

curl

curl -X POST https://gateway.pipeworx.io/edgar/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"edgar_search_filings","arguments":{"query":"artificial intelligence","form_type":"10-K","start_date":"2024-01-01","end_date":"2024-12-31","limit":20}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('edgar_search_filings', {
  "query": "artificial intelligence",
  "form_type": "10-K",
  "start_date": "2024-01-01",
  "end_date": "2024-12-31",
  "limit": 20
});

More examples

{
  "query": "Tesla revenue",
  "limit": 10
}

Response shape

Field	Type	Description
`query`	string	The search query used
`form_type_filter`	string	Form type filter applied or ‘all’
`date_range`	object
`total_hits`	number	Total number of matching filings
`results`	array

Full JSON Schema

{
  "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"
          }
        }
      }
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

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

See Getting Started for client-specific install steps.

edgar_search_filings