get_company_filings
Pack: sec · Endpoint: https://gateway.pipeworx.io/sec/mcp
Get recent SEC filings for a company using its CIK number. Returns filing dates, form types, and accession numbers. Optionally filter by form type (e.g., “10-K”, “10-Q”, “8-K”).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
cik | string | yes | Company CIK number (digits only, e.g., “320193” for Apple) |
form_type | string | no | Filter by SEC form type (e.g., “10-K”, “10-Q”, “8-K”, “DEF 14A”). Omit to return all recent filings. |
Example call
Arguments
{
"cik": "320193"
}
curl
curl -X POST https://gateway.pipeworx.io/sec/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_company_filings","arguments":{"cik":"320193"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('get_company_filings', {
"cik": "320193"
});
More examples
{
"cik": "1018724",
"form_type": "10-K"
}
Response shape
Always returns: cik, company_name, sic_description, state_of_incorporation, fiscal_year_end, filter_form_type, filings
| Field | Type | Description |
|---|---|---|
cik | string | Company CIK number |
company_name | string | Official company name from SEC |
sic_description | string | SEC SIC industry classification description |
state_of_incorporation | string | State where company is incorporated |
fiscal_year_end | string | Company’s fiscal year end date (MMDD format) |
filter_form_type | string | Form type filter applied (‘all’ if none specified) |
filings | array | Recent SEC filings (up to 20 results) |
Full JSON Schema
{
"type": "object",
"properties": {
"cik": {
"type": "string",
"description": "Company CIK number"
},
"company_name": {
"type": "string",
"description": "Official company name from SEC"
},
"sic_description": {
"type": "string",
"description": "SEC SIC industry classification description"
},
"state_of_incorporation": {
"type": "string",
"description": "State where company is incorporated"
},
"fiscal_year_end": {
"type": "string",
"description": "Company's fiscal year end date (MMDD format)"
},
"filter_form_type": {
"type": "string",
"description": "Form type filter applied ('all' if none specified)"
},
"filings": {
"type": "array",
"description": "Recent SEC filings (up to 20 results)",
"items": {
"type": "object",
"properties": {
"accession_number": {
"type": "string",
"description": "SEC accession number for the filing"
},
"filing_date": {
"type": "string",
"description": "Date filing was submitted to SEC (YYYY-MM-DD)"
},
"form": {
"type": "string",
"description": "SEC form type (e.g., 10-K, 10-Q, 8-K)"
},
"primary_document": {
"type": "string",
"description": "Primary document filename"
},
"document_url": {
"type": "string",
"description": "Full URL to the primary document on SEC website"
}
},
"required": [
"accession_number",
"filing_date",
"form",
"primary_document",
"document_url"
]
}
}
},
"required": [
"cik",
"company_name",
"sic_description",
"state_of_incorporation",
"fiscal_year_end",
"filter_form_type",
"filings"
]
}
Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"sec": {
"url": "https://gateway.pipeworx.io/sec/mcp"
}
}
}
See Getting Started for client-specific install steps.