What inputs does list_filing_sections accept?

ticker (string, required): Stock ticker, e.g. AAPL — or a CIK (SEC identifier), e.g. '0000320193'. A CIK is the stable identifier. accession (string, required): EDGAR accession number of the 10-K / 10-Q, e.g. '0000320193-19-000119'. Take it from get_sec_filing_links. as_of_date (string, optional): Point-in-time guard (YYYY-MM-DD). A filing is its own as-of: if it was accepted by the SEC after this date the call is refused rather than reading text that did not exist yet.

Which Valuein plans include list_filing_sections?

Available on every plan, including the free tier with no account. Not point-in-time safe.

Discovery

List Filing Sections

list_filing_sections

Sample and above

Table of contents of a 10-K / 10-Q (or 10-K/A, 10-Q/A) so an agent can read the filing's WORDS: returns the form, filing/period/acceptance dates, the primary-document URL, and every section found with its `key`, `title`, `char_count` and a short `first_line`. 10-K keys are the...

Example Call

example_call.pypython

# Using the Valuein MCP server from Python (via MCP SDK)# Or call directly from Claude / Cursor after setup result = await client.call_tool(    "list_filing_sections",    arguments={    "ticker": "EXAMPLE",    "accession": "EXAMPLE"})print(result)

Direct tool call:list_filing_sections(...)

Try it now

No token required

Paste this in your terminal — the free tier returns real S&P500 data without authentication.

try-it.shbash

# No auth required — the Sample tier covers S&P 500 constituents with a 5-year window.# Add -H "Authorization: Bearer $VALUEIN_TOKEN" for the full universe and history.curl -X POST https://mcp.valuein.biz/mcp \    -H "Content-Type: application/json" \    -H "Accept: application/json, text/event-stream" \    -d '{        "jsonrpc": "2.0",        "id": 1,        "method": "tools/call",        "params": {          "name": "list_filing_sections",          "arguments": {            "ticker": "AAPL",            "accession": "AAPL"          }        }      }'

Inputs

Parameter	Type	Required	Description
`ticker`	string	required	Stock ticker, e.g. AAPL — or a CIK (SEC identifier), e.g. '0000320193'. A CIK is the stable identifier.
`accession`	string	required	EDGAR accession number of the 10-K / 10-Q, e.g. '0000320193-19-000119'. Take it from get_sec_filing_links.
`as_of_date`	string	optional	Point-in-time guard (YYYY-MM-DD). A filing is its own as-of: if it was accepted by the SEC after this date the call is refused rather than reading text that did not exist yet.

Output Fields

tickeraccession_idform_typefiling_datereport_dateaccepted_atsource_urlsec_urltotal_charssectionsnotesprovenance_note

Example Response

Illustrative

response.jsonjson

{  "ticker": "AAPL",  "accession_id": "0000320193-24-000006",  "form_type": "10-K",  "filing_date": "2024-03-15",  "report_date": null,  "accepted_at": "2024-03-15",  "source_url": null,  "sec_url": "https://www.sec.gov/Archives/edgar/data/320193/..."}