`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 filing metadata + accession numbers + document links. 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

Always returns: query, form_type_filter, date_range, total_hits, results

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": [
            "string",
            "null"
          ],
          "description": "Start date in YYYY-MM-DD format or null"
        },
        "end": {
          "type": [
            "string",
            "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",
            "description": "Period covered by the filing"
          },
          "location": {
            "type": "string",
            "description": "Business location"
          },
          "filing_id": {
            "type": "string",
            "description": "Unique filing identifier"
          }
        }
      }
    }
  },
  "required": [
    "query",
    "form_type_filter",
    "date_range",
    "total_hits",
    "results"
  ]
}

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