edgar_filing_documents
Pack: edgar · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)
No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/edgar_filing_documents for the schema, then POST the same URL with its arguments for the data.
The documents and attachments inside one SEC filing, by accession number.
Tool description as the model sees it
AUTHORITATIVE list of the SEC filing documents inside ONE specific filing, by accession number. Retrieve a filing / its contents / attachments: pass the accession (e.g. “0000320193-25-000079”, with or without dashes) plus the filer’s ticker (“AAPL”) or CIK (“320193”). Returns every document in the filing folder — the primary document (10-K / 10-Q / 8-K body), all exhibits, and XBRL files — each with name, type, size, and a direct https URL, plus the filing’s form type, filing date, and human -index.html page. Set include_primary_text:true to also pull the primary document’s text (HTML stripped to plaintext, ~40k chars). Use to list a 10-K / 10-Q / 8-K’s exhibits, retrieve filing contents/attachments, or fetch the text of a filing. You can pass an exact accession, OR just a ticker + form_type to auto-resolve the latest matching filing (no accession lookup needed). Examples: edgar_filing_documents({ticker: “NVDA”, form_type: “10-K”}) for the documents in NVIDIA’s latest annual report; edgar_filing_documents({accession: “0000320193-25-000079”, ticker: “AAPL”, include_primary_text: true}) for a specific filing’s text.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
accession | string | no | Optional SEC accession number of a specific filing, with or without dashes (e.g. “0000320193-25-000079”). Omit it to auto-resolve the latest filing — pass form_type instead, and the response will say accession_source:"auto_selected" and list under auto_selected.candidates the other filings you might have meant. If the question names WHICH filing (a date, “the September 29 8-K”), pass filed or the accession rather than relying on that choice. |
ticker | string | no | The filer’s ticker (e.g. “AAPL”, “NVDA”) or company name. Provide this OR cik. Tickers are auto-resolved to CIKs. |
cik | string | no | The filer’s CIK number (e.g. “320193”). Provide this OR ticker. |
form_type | string | no | When accession is omitted, the form type of the latest filing to fetch, e.g. “10-K”, “10-Q”, “8-K”, “DEF 14A” — or a |-separated SET (“10-K|10-Q”) for “the most recent of either, whichever is newer”. Omit both accession and form_type to get the single most recent filing of ANY type at all (routine 8-Ks/Form 4s/Form 144s included, not just annual/quarterly reports) — use the | set instead when you specifically want the newest 10-K or 10-Q. |
filed | string | no | Only consider filings filed on this date, in this month, or in this year — “2026-09-29”, “2026-09”, “2026” (US spellings “09/29/2026” and “September 29, 2026” accepted). Pass this whenever the question names a date (“Tesla’s September 29 2026 8-K”): without it the NEWEST filing of that form is used, and for an 8-K that is routinely a different filing. |
filing_date | string | no | Alias for filed. |
include_primary_text | boolean | no | When true, also fetch the primary document and return its text (HTML stripped to plaintext, truncated to ~40,000 chars). Default false. For the FULL, pageable document text — or just one section like going-concern/liquidity — use edgar_filing_text instead. |
ticker_or_cik | string | no | Alias for ticker / cik — the single-argument spelling edgar_company_filings and edgar_insider_transactions use. Takes either a ticker or a CIK. |
Example call
Arguments
{
"ticker": "AAPL",
"form_type": "10-K",
"include_primary_text": true
}
curl
curl -X POST https://gateway.pipeworx.io/edgar/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"edgar_filing_documents","arguments":{"ticker":"AAPL","form_type":"10-K","include_primary_text":true}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('edgar_filing_documents', {
"ticker": "AAPL",
"form_type": "10-K",
"include_primary_text": true
});
More examples
{
"accession": "0000320193-25-000079",
"ticker": "AAPL"
}
Connect
Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:
{
"mcpServers": {
"pipeworx": {
"url": "https://pipeworx.io/mcp"
}
}
}
Connect to just the edgar pack
{
"mcpServers": {
"edgar": {
"url": "https://gateway.pipeworx.io/edgar/mcp"
}
}
}
See Getting Started for client-specific install steps.