Discovery
PIT-safe
Get SEC Filing Links
get_sec_filing_linkssample
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)
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 |
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_urlExample 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/..."
}
]Returns the last 5 AAPL 10-K filings with SEC EDGAR URLs.
Notes
PIT-safe: use as_of_date to avoid look-ahead bias in backtests. Links are direct SEC EDGAR URLs — always publicly accessible.
Plan Access
sample
✓ Availablesp500
✓ Availablefull
✓ Available