What inputs does read_filing_section 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. key (string, required): Section key from list_filing_sections: '7', '1A', 'I-2', 'II-1A', 'note-3', 'explanatory-note'. offset (integer, optional, default 0): Character offset to start from; use the previous page's next_offset. max_chars (integer, optional, default 20000): Page size in characters (1000-60000). Defaults to 20000.

Which Valuein plans include read_filing_section?

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

Discovery

Read Filing Section

read_filing_section

Sample and above

Read one section of a 10-K / 10-Q (or amendment) as plain text: MD&A (10-K `7`, 10-Q `I-2`), Risk Factors (`1A`, `II-1A`), Legal Proceedings, Controls, or a financial-statement note (`note-3`). Get valid keys and sizes from list_filing_sections. Tables come back as plain pipe ...

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(    "read_filing_section",    arguments={    "ticker": "EXAMPLE",    "accession": "EXAMPLE",    "key": "EXAMPLE"})print(result)

Direct tool call:read_filing_section(...)

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": "read_filing_section",          "arguments": {            "ticker": "AAPL",            "accession": "AAPL",            "key": "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.
`key`	string	required	Section key from list_filing_sections: '7', '1A', 'I-2', 'II-1A', 'note-3', 'explanatory-note'.
`offset`	integer	optional	Character offset to start from; use the previous page's next_offset.Default: `0`
`max_chars`	integer	optional	Page size in characters (1000-60000). Defaults to 20000.Default: `20000`

Output Fields

tickeraccession_idform_typefiling_datekeytitletextoffsetreturned_charsnext_offsettotal_charssource_urlprovenance_note

Example Response

Illustrative

response.jsonjson

{  "ticker": "AAPL",  "accession_id": "0000320193-24-000006",  "form_type": "10-K",  "filing_date": "2024-03-15",  "key": null,  "title": null,  "text": null,  "offset": null}