Skip to content
Load Factor Docs
Open Load Factor

MCP Tool

SEC filing timeline

Filing timeline of one SEC registrant.

  • MCP
  • Read-only
  • Updated

Declaration

MCP tool
sec_company_filings(
    cik: integer,
    form?: string,
    since?: string,
    limit?: integer,
    offset?: integer
)

Parameters

cikintegerRequired
SEC Central Index Key, e.g. 753308 (NextEra Energy). The typed id company:cik:753308 from search / sec_search_companies also works.
formstringOptional
SEC form type, e.g. 10-K, 10-Q, 8-K, 20-F (amendments included).
sincestringOptional
Only filings on or after this date: YYYY, YYYY-MM or YYYY-MM-DD.
limitintegerOptional
Filings to return (max 50).Default: 25
offsetintegerOptional
Skip this many filings (paging).Default: 0

Return Value

Returns {summary, company, filters, total, offset, next_offset, by_form, filings}: by_form counts all the registrant's filings, not just the filtered ones; each filing has form, filing_date, report_date, 8-K items, co_filers, accession, url (primary document) and index_url.

Discussion

Filing timeline of one SEC registrant (by CIK): form, filing and report dates, 8-K item numbers and a direct sec.gov link to each filing, newest first, with counts by form. Filter by form ('10-K' also matches '10-K/A') and since (YYYY or YYYY-MM-DD); page with offset. Filings are listed as filed with the SEC, for registrants a Load Factor analyst linked to a Load Factor company (sec_search_companies).

Returns {summary, company, filters, total, offset, next_offset, by_form, filings}: by_form counts all the registrant's filings, not just the filtered ones; each filing has form, filing_date, report_date, 8-K items, co_filers, accession, url (primary document) and index_url.

Example

Ask your assistant:

It would call the tool with a request like this one (your client builds and sends it for you):

tools/call request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "sec_company_filings",
    "arguments": {
      "cik": 753308,
      "form": "10-K"
    }
  }
}

Availability

Listed to accounts with the Developer Tracker or Map module. Results follow your Load Factor permissions (ISOs, detail level, evidence depth and rows per call). See Access & permissions.