Discovery
Filed Form Types
list_filing_formsSample and above
Which SEC form types each of up to 200 companies filed in the last N months (default 24), as a count per form, in ONE call. Use it to offer only forms a company set actually files (10-K, 10-Q, 20-F, 40-F, 6-K, 8-K, DEF 14A, ...). Amendments count toward their base form (10-K/A...
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( "list_filing_forms", arguments={ "tickers": []})print(result)Direct tool call:list_filing_forms(...)
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": "list_filing_forms", "arguments": { "tickers": [] } } }'Inputs
| Parameter | Type | Required | Description |
|---|---|---|---|
tickers | array | required | Tickers or CIKs, at most 200. |
months | integer | optional | Look-back window in months. Defaults to 24.Default: 24 |
Output Fields
sincecompaniesExample Response
Illustrative
response.jsonjson
{ "since": null, "companies": null}Shape only — field names match the live schema; values are placeholders, not real filings. See MCP server for the structured response shape.
Notes
Available from the Sample plan and above.
Plan Access
Sample (guest)
AvailableBenchmark (token)
AvailablePro
AvailableInstitutional
Available