edgar_filing_documents
Pack: edgar · Endpoint: https://gateway.pipeworx.io/edgar/mcp
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. |
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”. Omit both accession and form_type to get the single most recent filing of any type. |
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. |
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, or use one-click install buttons:
{
"mcpServers": {
"edgar": {
"url": "https://gateway.pipeworx.io/edgar/mcp"
}
}
}
See Getting Started for client-specific install steps.