Docs/Skills/SEC Filings Skill

SEC Filings Skill

Get a Company SEC Filing History by Ticker

OperationalCredits 6 per callp50 199msFinance

Overview

SEC Filings works by projecting the SEC EDGAR submissions feed for US public companies into a clean, decision-ready filing history. On top of the raw filing list it derives activity analytics - counts by form type, filing cadence, and days since the last annual, quarterly and current report - so you can see a company's disclosure activity at a glance rather than paging through EDGAR. Data is refreshed continuously from official SEC filings.

The tool

Once your client is connected to the VerveKit server, this appears in its tool list as SECFilingsSkill. It is read-only and open-world — it fetches and never mutates anything on your side — so most clients call it without asking you to confirm.

Tool call
{
  "name": "SECFilingsSkill",
  "arguments": {
    "ticker": "AAPL"
  }
}

You do not name the tool yourself; the model picks it. Asking about AAPL in the terms this skill covers is enough for it to reach for SECFilingsSkill on its own — naming it explicitly also works, and is the way to force the call.

Connecting

One server URL covers every skill in the catalog, including this one. Authorization is OAuth: the client opens a browser once, and there is no key to paste into a config file.

{
  "mcpServers": {
    "vervekit": {
      "url": "https://api.vervekit.com/v1/mcp"
    }
  }
}

Per-client setup — Claude, Cursor, VS Code, ChatGPT — is on the MCP setup page.

Arguments

These are the properties on the tool's inputSchema, so a well-behaved client validates them before the call is made. Premium arguments are accepted on every plan but only take effect on plans that include them.

ArgumentTypeDescription
tickerRequiredstringStock ticker symbol (e.g. AAPL, MSFT, ADBE)
length 1–6
formOptionalPremiumstringFilter to a single form type (e.g. 10-K, 10-Q, 8-K, 4).
limitOptionalPremiumintegerNumber of filings to return (1-50). Defaults to 5.
range 1–50

What the model gets back

The result carries a structuredContent object matching the tool's declared outputSchema, so a client reads fields without parsing prose. status is "ok" and error is null on success; a null field means the value was not available for that input, not that the call failed.

Result
{
  "status": "ok",
  "error": null,
  "data": {
    "ticker": "AAPL",
    "cik": "0000320193",
    "company": "Apple Inc.",
    "sic": "3571",
    "sicDescription": "Electronic Computers",
    "fiscalYearEnd": "0927",
    "totalRecentFilings": 1000,
    "count": 4,
    "latest": {
      "annual": {
        "form": "10-K",
        "filingDate": "2025-11-01",
        "accessionNumber": "0000320193-25-000123",
        "primaryDocument": "aapl-20250927.htm",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000123/aapl-20250927.htm",
        "daysAgo": 62
      },
      "quarterly": {
        "form": "10-Q",
        "filingDate": "2025-08-01",
        "accessionNumber": "0000320193-25-000106",
        "primaryDocument": "aapl-20250628.htm",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000106/aapl-20250628.htm",
        "daysAgo": 154
      },
      "currentReport": {
        "form": "8-K",
        "filingDate": "2025-10-30",
        "accessionNumber": "0000320193-25-000121",
        "primaryDocument": "aapl-20251030.htm",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000121/aapl-20251030.htm",
        "daysAgo": 64
      }
    },
    "filings": [
      {
        "form": "10-K",
        "filingDate": "2025-11-01",
        "reportDate": "2025-09-27",
        "primaryDocDescription": "10-K",
        "accessionNumber": "0000320193-25-000123",
        "primaryDocument": "aapl-20250927.htm",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000123/aapl-20250927.htm",
        "items": null,
        "isXBRL": true
      },
      {
        "form": "8-K",
        "filingDate": "2025-10-30",
        "reportDate": "2025-10-30",
        "primaryDocDescription": "8-K",
        "accessionNumber": "0000320193-25-000121",
        "primaryDocument": "aapl-20251030.htm",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000121/aapl-20251030.htm",
        "items": "2.02,9.01",
        "isXBRL": true
      },
      {
        "form": "4",
        "filingDate": "2025-10-16",
        "reportDate": "2025-10-14",
        "primaryDocDescription": "FORM 4",
        "accessionNumber": "0000320193-25-000118",
        "primaryDocument": "xslF345X05/wf-form4.xml",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000118/xslF345X05/wf-form4.xml",
        "items": null,
        "isXBRL": false
      },
      {
        "form": "10-Q",
        "filingDate": "2025-08-01",
        "reportDate": "2025-06-28",
        "primaryDocDescription": "10-Q",
        "accessionNumber": "0000320193-25-000106",
        "primaryDocument": "aapl-20250628.htm",
        "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000106/aapl-20250628.htm",
        "items": null,
        "isXBRL": true
      }
    ],
    "analytics": {
      "formCounts": {
        "3": 22,
        "4": 512,
        "8-K": 96,
        "10-Q": 84,
        "10-K": 28,
        "DEF 14A": 27,
        "SC 13G": 41
      },
      "filingsLast30Days": 3,
      "filingsLast90Days": 9,
      "filingsLast365Days": 74,
      "daysSinceLastFiling": 62,
      "daysSinceLastAnnual": 62,
      "daysSinceLastQuarterly": 154,
      "averageDaysBetweenFilings": 12.4,
      "mostActiveForm": "4"
    }
  }
}

Response fields

Paths are relative to data. Premium fields are absent rather than zeroed on plans that do not include them, so check for presence instead of comparing to 0.

FieldTypeExampleDescription
tickerstringAAPLStock ticker symbol for the company
cikstring0000320193SEC Central Index Key unique identifier
companystringApple Inc.Official registered name of the company
sicstring3571Standard Industrial Classification code
sicDescriptionstringElectronic ComputersIndustry description for the SIC code
fiscalYearEndstring0927Fiscal year end in MMDD format
totalRecentFilingsnumber1000Total filings in the company's recent EDGAR feed
countnumber4Number of filings returned in this response
latestobject{…}Most recent filing of each headline type
latest.annualPremiumobject{…}Most recent 10-K annual report
latest.annual.formPremiumstring10-KForm type (10-K)
latest.annual.filingDatePremiumstring2025-11-01Date the annual report was filed
latest.annual.accessionNumberPremiumstring0000320193-25-000123SEC accession number for the filing
latest.annual.primaryDocumentPremiumstringaapl-20250927.htmPrimary document filename
latest.annual.urlPremiumstringhttps://www.sec.gov/Archives/edgar/data/320193/000032019325000123/aapl-20250927.htmDirect link to the filing document
latest.annual.daysAgoPremiumnumber62Days since the annual report was filed
latest.quarterlyPremiumobject{…}Most recent 10-Q quarterly report
latest.quarterly.formPremiumstring10-QForm type (10-Q)
latest.quarterly.filingDatePremiumstring2025-08-01Date the quarterly report was filed
latest.quarterly.accessionNumberPremiumstring0000320193-25-000106SEC accession number for the filing
latest.quarterly.primaryDocumentPremiumstringaapl-20250628.htmPrimary document filename
latest.quarterly.urlPremiumstringhttps://www.sec.gov/Archives/edgar/data/320193/000032019325000106/aapl-20250628.htmDirect link to the filing document
latest.quarterly.daysAgoPremiumnumber154Days since the quarterly report was filed
latest.currentReportPremiumobject{…}Most recent 8-K current report
latest.currentReport.formPremiumstring8-KForm type (8-K)
latest.currentReport.filingDatePremiumstring2025-10-30Date the current report was filed
latest.currentReport.accessionNumberPremiumstring0000320193-25-000121SEC accession number for the filing
latest.currentReport.primaryDocumentPremiumstringaapl-20251030.htmPrimary document filename
latest.currentReport.urlPremiumstringhttps://www.sec.gov/Archives/edgar/data/320193/000032019325000121/aapl-20251030.htmDirect link to the filing document
latest.currentReport.daysAgoPremiumnumber64Days since the current report was filed
filingsarray[4]Recent filings, most recent first
filings.0.formstring10-KSEC form type (10-K, 10-Q, 8-K, 4, ...)
filings.0.filingDatestring2025-11-01Date the filing was submitted
filings.0.reportDatestring2025-09-27Period or event date the filing reports on
filings.0.primaryDocDescriptionstring10-KDescription of the primary document
filings.0.accessionNumberstring0000320193-25-000123SEC accession number for the filing
filings.0.primaryDocumentstringaapl-20250927.htmPrimary document filename
filings.0.urlstringhttps://www.sec.gov/Archives/edgar/data/320193/000032019325000123/aapl-20250927.htmDirect link to the filing document
filings.0.itemsobjectnull8-K item numbers disclosed, when applicable
filings.0.isXBRLbooleantrueWhether the filing includes XBRL structured data
analyticsobject{…}
analytics.formCountsPremiumobject{…}Count of filings by form type in the recent feed
analytics.formCounts.3Premiumnumber22
analytics.formCounts.4Premiumnumber512
analytics.formCounts.8-KPremiumnumber96
analytics.formCounts.10-QPremiumnumber84
analytics.formCounts.10-KPremiumnumber28
analytics.formCounts.DEF 14APremiumnumber27
analytics.formCounts.SC 13GPremiumnumber41
analytics.filingsLast30DaysPremiumnumber3Number of filings in the last 30 days
analytics.filingsLast90DaysPremiumnumber9Number of filings in the last 90 days
analytics.filingsLast365DaysPremiumnumber74Number of filings in the last 365 days
analytics.daysSinceLastFilingPremiumnumber62Days since the most recent filing of any type
analytics.daysSinceLastAnnualPremiumnumber62Days since the most recent 10-K
analytics.daysSinceLastQuarterlyPremiumnumber154Days since the most recent 10-Q
analytics.averageDaysBetweenFilingsPremiumnumber12.4Average days between recent filings
analytics.mostActiveFormPremiumstring4Most frequently filed form type

Failure modes

Errors come back as tool errors carrying a sentence the model can act on, not a bare status code. Error handling covers the full list.

StatusWhat it means
400 / 422The arguments did not validate. The message names the offending one.
401The OAuth session is invalid or expired — reconnect the server.
403Blocked by a key restriction or an IP allow-list. Never a bad identity.
404This skill is not part of VerveKit. Check the catalog.
429Out of credits, or a brief rate limit. The message tells them apart.

A call costs 6 credits each time the tool actually runs; a model that reasons about the tool without calling it costs nothing.

Other ways to use SEC Filings Skill

Set up SEC Filings Skill on VerveKit, or reach the same source a different way. Your VerveKit account and credits work on all of them — one key, one balance.

Call it as a REST APIOne HTTPS endpoint and an x-api-key header, with SDKs for Node, Python and .NET.APIVerveReference →
Google Sheets or ExcelA =VERVE() formula fills a column — no script, no export, recalculates in place.VerveSheetsReference →
Ground an agent on itA cited, machine-checkable fact your model can't produce on its own.VerveContextReference →

More in Finance:

Was this page helpful?