SEC Full-Text Search

Coming soon

The v2 MCP API is in preview and not yet generally available. These pages document its tools and request/response shapes; live data access is limited to enrolled organizations until v2 is released.

Search within SEC filing content (the EDGAR full-text index) for specific terms or phrases. Thin wrapper around the sec-api.io full-text-search API. Accepts ticker symbols and resolves them to CIKs automatically.

Use when the user wants filings that mention or contain a term/phrase. Supports AND, OR, NOT, wildcards (*), and exact phrases ("quoted"). Generic words like "award" also match boilerplate (stock awards) — prefer exact phrases.

DO NOT USE to extract a named section ("risk factors", "MD&A") from a specific filing — use sec_filing_section (it calls this concept filingType, a singular enum, not formTypes). For company background (revenue, employees, technographics) use company_enrich; for non-SEC web info use web_search.

DOMAIN→TICKER: accepts tickers only, not domains. Given a domain or name, resolve it to a ticker first (via web_search or company_firmographic) — company_firmographic does not itself return filing text.

SCOPING: omitting BOTH tickers and formTypes searches the entire EDGAR corpus and can return a capped ~10,000-result flood of unrelated issuers (total is approximate at that cap). Always pass tickers (preferred) or at least formTypes unless a cross-company sweep is intended.

DATES: startDate defaults to the last 30 days. Annual filings (10-K, 20-F, 40-F) are yearly — pass startDate "2020-01-01" for them or you get zero results.

Returns up to 100 filings per page with direct EDGAR URLs. If resolvedCiks in searchParams is empty after passing tickers, the ticker filter was NOT applied and results are unfiltered — check it (and warnings) before treating results as company-specific.

Parameters

Name	Type	Required	Default	Description
query	string	❌ No	cybersecurity incident	Search query. Supports AND, OR, NOT, wildcards (*), and exact phrases ("quoted"). NOT for extracting a named section from a specific filing — use sec_filing_section. Scope broad/common-word queries with tickers or formTypes; a bare query searches the entire EDGAR corpus.
formTypes	array	❌ No	-	Filter by SEC form type (e.g., ["8-K", "10-K", "20-F"]). Recommended for wildcard queries to reduce noise: ["8-K", "10-K", "10-Q"]. Matching is family-based, not exact: ["10-K"] also returns 10-K/A and NT 10-K; ["8-K"] also returns 8-K/A and CORRESP. Post-filter on each result's formType field if you need exact types. Note: sec_filing_section calls this concept filingType — a singular enum string, not an array.
tickers	array	❌ No	-	Filter by company ticker symbol (e.g., ["MSFT", "AAPL"]). Resolved to CIKs automatically via the sec-api.io Mapping API for real server-side filtering. IMPORTANT: if resolvedCiks in the response is empty, the ticker(s) could not be resolved and NO filter was applied — results are the full unfiltered corpus, not company-specific. Always check resolvedCiks (and the warnings array) before trusting results as company-specific. Some foreign/ADR issuers may not resolve.
startDate	string	❌ No	-	Start date (YYYY-MM-DD). Defaults to 30 days ago. For annual filings (10-K, 20-F, 40-F) pass "2020-01-01" — the 30-day default misses most annual reports.
endDate	string	❌ No	-	End date (YYYY-MM-DD). Defaults to today.
page	string	❌ No	1	Page of results (default "1"). Each page returns up to 100 filings. Use "2", "3", etc. to paginate.

Required Integrations

• sec_api

Use Cases

• Find every filing that mentions a term across companies — "who disclosed a 'material weakness'?"
• Scan for a risk or event phrase: "going concern", "substantial doubt", "cybersecurity incident"
• Track M&A language across the market: acquisition, merger, "definitive agreement"
• List recent filings for one company by ticker without knowing the specific document
• Search foreign-issuer disclosures via formTypes (["20-F"], ["6-K"], ["40-F"])

Example Usage

Companies disclosing a material weakness in their annual reports since 2024

{
  "tool": "sec_full_text_search",
  "arguments": {
    "query": "\"material weakness\"",
    "formTypes": [
      "10-K"
    ],
    "startDate": "2024-01-01"
  }
}

Cyber breach language in 8-Ks since 2020

{
  "tool": "sec_full_text_search",
  "arguments": {
    "query": "cybersecurity AND breach",
    "formTypes": [
      "8-K"
    ],
    "startDate": "2020-01-01"
  }
}

Filings mentioning "supply chain" in Microsoft disclosures since 2020

{
  "tool": "sec_full_text_search",
  "arguments": {
    "query": "\"supply chain\"",
    "tickers": [
      "MSFT"
    ],
    "startDate": "2020-01-01"
  }
}

Related Tools

sec_filing_section, company_enrich, web_search, company_contracts