US SEC filings list

us_get_sec_filings

TW-specificMIT

**關鍵字 / Keywords**: SEC EDGAR 美股申報財報 10-K 10-Q 8-K DEF-14A Form-4 annual report quarterly current insider proxy filings list company CIK filing date

Scope: US public companies filing with the SEC (EDGAR).

List a filer's recent filings, optionally filtered by form type
and filing-date range.

Endpoint:
    https://data.sec.gov/submissions/CIK{cik10}.json
    (the filings.recent block · ~1000 most recent filings)

Args:
    cik: CIK (zero-padded or not) or "CIK…" form (e.g. "0000320193"
         for Apple, "0000789019" for Microsoft, "0001046179" for TSMC).
    form_types: filter to specific form(s) — common: "10-K"
                (annual report), "10-Q" (quarterly), "8-K"
                (current event), "DEF 14A" (proxy), "4" (insider
                transactions), "SC 13G" (5%+ holder). Case-insensitive.
                Pass None to include every form.
    date_from / date_to: YYYY-MM-DD filing-date bounds (inclusive).
    limit: max rows returned (default 40).

Returns dict with `filings` — each row has `accession_number`,
`form`, `filing_date`, `report_date`, `primary_document`,
`primary_document_description`, `is_xbrl`, `is_inline_xbrl`,
`original_url` (direct link to the primary document on
www.sec.gov/Archives), plus `older_file_pointers` for filings
older than the recent 1000. License: US Public Domain.

Input schema

{
  "properties": {
    "cik": {
      "title": "Cik",
      "type": "string"
    },
    "form_types": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Form Types"
    },
    "date_from": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Date From"
    },
    "date_to": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Date To"
    },
    "limit": {
      "default": 40,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "cik"
  ],
  "title": "us_get_sec_filingsArguments",
  "type": "object"
}

How to call

Once your Twinkle Hub MCP client is configured, your agent will see us_get_sec_filings. Just ask it to call — example:

# Ask Claude / any MCP client:
請用 us_get_sec_filings 處理 "…"。

# It will call:
us_get_sec_filings(input="…")

Haven't set up a client yet?

Claude Desktop in 3 minutes — download the .mcpb and double-click, or see docs for other clients.

See user docs