What inputs does get_sec_filing_links accept?

ticker (string, required): Stock ticker symbol, e.g. AAPL, MSFT — or a CIK (SEC identifier), e.g. '0000320193'. form_types (array, optional, default ["10-K","10-Q"]): Filing form types to include. Defaults to 10-K and 10-Q. start_date (string, optional): Inclusive lower bound on filing_date (YYYY-MM-DD). E.g. '2023-01-01'. end_date (string, optional): Inclusive upper bound on filing_date (YYYY-MM-DD). E.g. '2023-12-31'. event_types (array, optional): 8-K item codes to filter by. E.g. ['1.01'] for material agreements, ['2.01'] for asset acquisitions, ['5.02'] for director/officer changes. Only relevant when form_types includes '8-K'. limit (integer, optional, default 10): Maximum number of filings to return (1–50). Defaults to 10.

Which Valuein plans include get_sec_filing_links?

Available on every plan, including the free tier with no account. Point-in-time safe via as_of_date filtering.

Discovery

PIT-safe

SEC Filing Links

get_sec_filing_links

Sample and above

Get direct links to original SEC EDGAR filings for any US public company. Returns four per-filing deep links: `sec_url` (the EDGAR filing-index page listing every document), `viewer_url` (the cgi-bin Financial-Report viewer for the specific accession), `inline_viewer_url` (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(    "get_sec_filing_links",    arguments={    "ticker": "EXAMPLE"})print(result)

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

Try it now

No token required

Paste this in your terminal — the free tier returns real sample data without authentication.

try-it.shbash

# No auth required — the Sample tier covers a large-cap US benchmark universe 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": "get_sec_filing_links",          "arguments": {            "ticker": "AAPL",            "limit": 3          }        }      }'

Inputs

Parameter	Type	Required	Description
`ticker`	string	required	Stock ticker symbol, e.g. AAPL, MSFT — or a CIK (SEC identifier), e.g. '0000320193'.
`form_types`	array	optional	Filing form types to include. Defaults to 10-K and 10-Q.Default: `["10-K","10-Q"]`
`start_date`	string	optional	Inclusive lower bound on filing_date (YYYY-MM-DD). E.g. '2023-01-01'.
`end_date`	string	optional	Inclusive upper bound on filing_date (YYYY-MM-DD). E.g. '2023-12-31'.
`event_types`	array	optional	8-K item codes to filter by. E.g. ['1.01'] for material agreements, ['2.01'] for asset acquisitions, ['5.02'] for director/officer changes. Only relevant when form_types includes '8-K'.
`limit`	integer	optional	Maximum number of filings to return (1–50). Defaults to 10.Default: `10`

Output Fields

tickerfilings_returnedfilings

Example Response

Illustrative

response.jsonjson

[  {    "ticker": "AAPL",    "filings_returned": null,    "filings": null  }]

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.

Try this tool

Get token All tools

CategoryDiscovery

PIT-safeYes

Min planSample

Inputs6 (1 required)

Plan Access

Sample (guest)

Available

Benchmark (token)

Available

Pro

Available

Institutional

Available

Related Tools

search_companies

Search Companies

get_company_fundamentals

Company Fundamentals

get_valuation_metrics

Valuation Metrics

get_financial_ratios

Financial Ratios

Resources

Point-in-Time methodology →Parquet schema reference →Bulk Data API reference →Python SDK guide →

Index names are trademarks of their owners; Valuein is not affiliated with or endorsed by any index provider.