What inputs does get_sec_filing_links accept?

ticker (string, required): Ticker symbol (e.g. AAPL, MSFT) form_type (string, optional): Filter by form type: 10-K, 10-Q, 8-K, 20-F, 40-F limit (integer, optional): Maximum filings to return (1–50). Defaults to 10. as_of_date (string, optional): YYYY-MM-DD. Only return filings accepted on or before this date (PIT-safe).

Which Valuein plans include get_sec_filing_links?

Available on: sample, sp500, full. Point-in-time safe via as_of_date filtering.

MCP Tools/get_sec_filing_links

Discovery

PIT-safe

SEC Filing Links

get_sec_filing_links

sample

sp500

full

Retrieve SEC EDGAR filing URLs for a company. Returns accession IDs, form types, filing dates, and direct links to the SEC EDGAR viewer. Use as_of_date to retrieve only filings that were publicly available at a specific point in time.

Example Call

# Using the Valuein MCP server from Python (via MCP SDK)
# Or call directly from Claude / Cursor after setup

result = await client.call_tool(
    "get_sec_filing_links",
    arguments={
    "ticker": "EXAMPLE"
}
)
print(result)

Direct tool call:get_sec_filing_links(ticker="AAPL", form_type="10-K", limit=5)

Try it now

No token required

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

# No auth required — sample tier covers S&P500 with a 5-year window.
# Add an Authorization: Bearer header for full universe and history.
$ curl -X POST https://mcp.valuein.biz/mcp \
    -H "Content-Type: application/json" \
    -d '{
        "jsonrpc": "2.0",
        "id": 1,
        "method": "tools/call",
        "params": {
          "name": "get_sec_filing_links",
          "arguments": {
            "ticker": "AAPL",
            "limit": 3
          }
        }
      }'

Inputs

Parameter	Type	Required	Description
`ticker`	string	required	Ticker symbol (e.g. AAPL, MSFT)
`form_type`	string	optional	Filter by form type: 10-K, 10-Q, 8-K, 20-F, 40-F
`limit`	integer	optional	Maximum filings to return (1–50). Defaults to 10.
`as_of_date`	string	optional	YYYY-MM-DD. Only return filings accepted on or before this date (PIT-safe).

Output Fields

accession_idform_typefiling_datereport_datefiscal_yearfiscal_periodis_amendmentsec_urlviewer_url

Example Response

[
  {
    "accession_id": "0000320193-24-000006",
    "form_type": "10-K",
    "filing_date": "2024-03-15",
    "report_date": null,
    "fiscal_year": 2024,
    "fiscal_period": "FY",
    "is_amendment": true,
    "sec_url": "https://www.sec.gov/Archives/edgar/data/320193/..."
  }
]