`edgar_company_snapshot`

Pack: edgar · Endpoint: https://gateway.pipeworx.io/edgar/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/edgar_company_snapshot for the schema, then POST the same URL with its arguments for the data.

A US public company’s SEC identity, recent filings and headline financials in one call.

Tool description as the model sees it

ONE CALL for “give me the SEC picture on $TICKER” / “what has $COMPANY filed recently and what are its numbers” / “pull the filings and financials for X”. Resolves a ticker, company name or CIK and returns, from SEC EDGAR, the three things callers otherwise chain by hand across edgar_ticker_to_cik -> edgar_company_filings -> edgar_company_concept: the identity (cik, company_name, tickers, SIC code, fiscal year end), the recent filings list (accession numbers, form types, filing dates, document links — by default the substantive forms 10-K/10-Q/8-K/20-F/40-F/6-K/DEF 14A, so insider Form 4 noise is excluded; pass form_type for one form or “all”), and the headline XBRL figures from the latest annual report (revenue, net income, operating income, gross profit, assets, liabilities, equity, cash, EPS, shares, R&D — each resolved to the concept the filer CURRENTLY reports under, with retired concepts listed separately as stale). Send the company as ticker_or_cik; cik / ticker are accepted aliases. A filer with no XBRL facts (a fund, a trust, a foreign private issuer on paper forms) still returns its filings, with financials_status: "unavailable" and a reason, not an error. Drill down from here: edgar_filing_text for a filing’s text, edgar_company_concept for one metric’s multi-year history, edgar_company_facts for every concept. For a cross-source view (patents, contracts, hiring, news) use entity_profile instead.

Parameters

Name	Type	Required	Description
`ticker_or_cik`	string	no	REQUIRED (or one of its aliases `cik` / `ticker`). Ticker (“AAPL”), company name (“Apple Inc”) or CIK (“320193”). Tickers and names are resolved to a CIK internally.
`cik`	string	no	Alias for `ticker_or_cik` — same thing. The spelling edgar_company_facts and edgar_company_concept use.
`ticker`	string	no	Alias for `ticker_or_cik` — same thing. The spelling edgar_ticker_to_cik uses.
`form_type`	string	no	Which filings to list. Omit for the substantive default set (10-K, 10-K/A, 10-Q, 10-Q/A, 8-K, 20-F, 40-F, 6-K, DEF 14A). Pass one form (“10-K”) to list only that form, or “all” for every form including Form 4 insider filings.
`filings_limit`	number	no	How many filings to return after the form filter (1-40, default 10).

Example call

Arguments

{
  "ticker_or_cik": "AAPL"
}

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_company_snapshot","arguments":{"ticker_or_cik":"AAPL"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('edgar_company_snapshot', {
  "ticker_or_cik": "AAPL"
});

More examples

{
  "ticker_or_cik": "NVDA",
  "form_type": "10-K",
  "filings_limit": 5
}

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.

edgar_company_snapshot