extract_sec_filings

Fetch SEC 8-K filings to monitor material corporate events like CEO changes, acquisitions, data breaches, and regulatory actions for public companies using company names, tickers, or keywords.

Instructions

Fetch SEC 8-K filings for any public company from the SEC EDGAR full-text search API. 8-K filings are legally mandated disclosures of material corporate events — CEO changes, acquisitions, data breaches, major contracts, regulatory actions — filed within 4 business days. Free, no auth, real-time. Pass a company name, ticker, or keyword. Unique: not available in any other MCP server.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`url`	Yes	Company name, ticker, or keyword e.g. 'Palantir', 'PLTR', 'artificial intelligence'
`max_length`	No

Implementation Reference

src/adapters/secFilings.ts:133-141 (handler)

The implementation of the 'secFilingsAdapter' function that acts as the handler for the 'extract_sec_filings' tool.

export async function secFilingsAdapter(options: ExtractOptions): Promise<AdapterResult> {
  const query = (options.url ?? "").trim();
  const maxLength = options.maxLength ?? 6000;

  if (!query) throw new Error("Company name or keyword required");

  const data = await fetchSecFilings(query);
  return formatFilings(data, query, maxLength);
}

src/server.ts:429-449 (registration)

The registration of the 'extract_sec_filings' tool using 'server.registerTool' within 'src/server.ts'.

server.registerTool(
  "extract_sec_filings",
  {
    description:
      "Fetch SEC 8-K filings for any public company from the SEC EDGAR full-text search API. 8-K filings are legally mandated disclosures of material corporate events — CEO changes, acquisitions, data breaches, major contracts, regulatory actions — filed within 4 business days. Free, no auth, real-time. Pass a company name, ticker, or keyword. Unique: not available in any other MCP server.",
    inputSchema: z.object({
      url: z.string().describe("Company name, ticker, or keyword e.g. 'Palantir', 'PLTR', 'artificial intelligence'"),
      max_length: z.number().optional().default(6000),
    }),
    annotations: { readOnlyHint: true, openWorldHint: true },
  },
  async ({ url, max_length }) => {
    try {
      const result = await secFilingsAdapter({ url, maxLength: max_length });
      const ctx = stampFreshness(result, { url, maxLength: max_length }, "sec_filings");
      return { content: [{ type: "text", text: formatForLLM(ctx) }] };
    } catch (err) {
      return { content: [{ type: "text", text: formatSecurityError(err) }] };
    }
  }
);

src/server.ts:434-437 (schema)

The input schema definition for 'extract_sec_filings' tool, specifying 'url' and 'max_length' arguments.

inputSchema: z.object({
  url: z.string().describe("Company name, ticker, or keyword e.g. 'Palantir', 'PLTR', 'artificial intelligence'"),
  max_length: z.number().optional().default(6000),
}),

freshcontext-mcp