US SEC single filing metadata

us_get_sec_filing

TW-specificMIT

**關鍵字 / Keywords**: SEC EDGAR 美股財報申報 filing accession primary document 10-K 10-Q 8-K URL cite metadata single filing detail

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

Look up one filing by CIK + accession number. Returns full metadata
plus the direct URL to the primary document — the filing body is
NOT downloaded inline (agents crawl on demand via `original_url`).

Endpoint:
    https://data.sec.gov/submissions/CIK{cik10}.json
    (looks up accession in the filings.recent block)

Args:
    cik: CIK (zero-padded or not).
    accession_number: SEC accession, dashed ("0000320193-25-000079")
                      or undashed ("000032019325000079") — either works.

Returns dict with `form`, `filing_date`, `report_date`,
`acceptance_datetime`, `primary_document`, `primary_document_url`,
`filing_index_url`, `is_xbrl`, `is_inline_xbrl`, `size_bytes`,
`items` (for 8-K), plus `original_url` = primary_document_url. If
the accession predates the recent-1000 window, returns
`error="not_in_recent_1000"` + `older_file_pointers` telling the
agent where to look next. License: US Public Domain.

Input schema

{
  "properties": {
    "cik": {
      "title": "Cik",
      "type": "string"
    },
    "accession_number": {
      "title": "Accession Number",
      "type": "string"
    }
  },
  "required": [
    "cik",
    "accession_number"
  ],
  "title": "us_get_sec_filingArguments",
  "type": "object"
}

How to call

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

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

# It will call:
us_get_sec_filing(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