Discovery
PIT-safe
SEC Filing Links
get_sec_filing_linksFree
Pro · Institutional
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
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( "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 free tier returns real S&P500 data without authentication.
try-it.shbash
# 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_urlinline_viewer_urldocument_urlExample Response
Illustrative
response.jsonjson
[ { "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/..." }]Shape only — field names match the live schema; values are placeholders, not real filings. 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
Free (guest)
AvailableFree (token)
AvailablePro · Institutional
Available