MCP Tool
SEC filing timeline
Filing timeline of one SEC registrant.
- MCP
- Read-only
- Updated
Declaration
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_companiesalso 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:
List NextEra Energy's 10-K filings on SEC EDGAR.
It would call the tool with a request like this one (your client builds and sends it for you):
{
"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.