`search_filings`

Pack: sec-xbrl · Endpoint: https://gateway.pipeworx.io/sec-xbrl/mcp

Search recent SEC filings for a company by CIK. Optionally filter by filing type (10-K, 10-Q, 8-K, etc.). Returns filing dates, types, and accession numbers.

Parameters

Name	Type	Required	Description
`cik`	string	yes	SEC Central Index Key (e.g., “320193” for Apple)
`type`	string	no	Filing type filter (e.g., “10-K”, “10-Q”, “8-K”, “DEF 14A”)

Example call

Arguments

{
  "cik": "320193"
}

curl

curl -X POST https://gateway.pipeworx.io/sec-xbrl/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_filings","arguments":{"cik":"320193"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('search_filings', {
  "cik": "320193"
});

More examples

{
  "cik": "789019",
  "type": "10-K"
}

Response shape

Always returns: cik, name, tickers, exchanges, sic, sic_description, state_of_incorporation, filing_count, filings

Field	Type	Description
`cik`	string	SEC Central Index Key
`name`	string	Legal name of the company
`tickers`	array	Stock ticker symbols
`exchanges`	array	Stock exchange listings
`sic`	string	Standard Industrial Classification code
`sic_description`	string	Industry description from SIC
`state_of_incorporation`	string	State where company is incorporated
`filing_count`	number	Total number of filings matching criteria
`filings`	array	Up to 25 recent filings

Full JSON Schema

{
  "type": "object",
  "properties": {
    "cik": {
      "type": "string",
      "description": "SEC Central Index Key"
    },
    "name": {
      "type": "string",
      "description": "Legal name of the company"
    },
    "tickers": {
      "type": "array",
      "description": "Stock ticker symbols",
      "items": {
        "type": "string"
      }
    },
    "exchanges": {
      "type": "array",
      "description": "Stock exchange listings",
      "items": {
        "type": "string"
      }
    },
    "sic": {
      "type": "string",
      "description": "Standard Industrial Classification code"
    },
    "sic_description": {
      "type": "string",
      "description": "Industry description from SIC"
    },
    "state_of_incorporation": {
      "type": "string",
      "description": "State where company is incorporated"
    },
    "filing_count": {
      "type": "number",
      "description": "Total number of filings matching criteria"
    },
    "filings": {
      "type": "array",
      "description": "Up to 25 recent filings",
      "items": {
        "type": "object",
        "properties": {
          "accession_number": {
            "type": "string",
            "description": "SEC accession number for the filing"
          },
          "filing_date": {
            "type": "string",
            "description": "Date filing was submitted (ISO format)"
          },
          "report_date": {
            "type": "string",
            "description": "Report period end date (ISO format)"
          },
          "form": {
            "type": "string",
            "description": "Form type (10-K, 10-Q, 8-K, etc)"
          },
          "document": {
            "type": "string",
            "description": "Primary document filename"
          },
          "description": {
            "type": "string",
            "description": "Document description"
          }
        },
        "required": [
          "accession_number",
          "filing_date",
          "report_date",
          "form",
          "document",
          "description"
        ]
      }
    }
  },
  "required": [
    "cik",
    "name",
    "tickers",
    "exchanges",
    "sic",
    "sic_description",
    "state_of_incorporation",
    "filing_count",
    "filings"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "sec-xbrl": {
      "url": "https://gateway.pipeworx.io/sec-xbrl/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

search_filings