`edgar_company_concept`

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

AUTHORITATIVE historical financials for any US public company. Source: SEC XBRL filings (the official numbers companies file, not third-party scrapes). Pass a ticker or CIK plus a friendly metric name — Revenue, NetIncomeLoss, Cash, LongTermDebt, EarningsPerShareDiluted — and the tool resolves the right XBRL tag for that filer (post-ASC-606 companies use RevenueFromContractWithCustomerExcludingAssessedTax instead of “Revenues”, etc.). Returns both ANNUAL (10-K) and QUARTERLY (10-Q) values by default, each labeled with fiscal_period (FY/Q1/Q2/Q3) and form, newest first, PLUS a latest field holding the single freshest data point. Use latest for point-in-time metrics like cash, runway, and debt — it is the newest 10-Q when one is more recent than the last 10-K, so a stale annual figure never masks a newer quarter. Use for “what was AAPL’s revenue in 2024”, “NVDA’s latest cash position”, “show me long-term debt trend”, anything where you need the SEC-filed number rather than an estimate.

Parameters

Name	Type	Required	Description
`cik`	string	yes	Ticker (e.g., “AAPL”) or CIK number (e.g., “320193”). Tickers are auto-resolved.
`concept`	string	yes	Metric name. Common: “Revenue” / “Revenues”, “NetIncomeLoss”, “Cash”, “Assets”, “Liabilities”, “StockholdersEquity”, “EarningsPerShareDiluted”, “LongTermDebt”.
`period`	string	no	Which reporting periods to return: “all” (default — annual 10-K + quarterly 10-Q), “annual” (10-K/20-F/40-F only), or “quarterly” (10-Q only). Point-in-time metrics (cash/runway/debt) usually want the default so the freshest quarter is included; use “annual” for clean year-over-year trends.

Example call

Arguments

{
  "cik": "320193",
  "concept": "Revenue"
}

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_concept","arguments":{"cik":"320193","concept":"Revenue"}}}'

TypeScript (@pipeworx/sdk)

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

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

More examples

{
  "cik": "1652044",
  "concept": "NetIncomeLoss"
}

Response shape

Always returns: cik, company_name, concept, label, description, annual_values

Field	Type	Description
`cik`	string	Company CIK number
`company_name`	string	Official company name
`concept`	string	US-GAAP concept tag name
`label`	string	Human-readable concept label
`description`	string	Detailed concept description
`annual_values`	array	Annual values sorted by fiscal year descending

Full JSON Schema

{
  "type": "object",
  "properties": {
    "cik": {
      "type": "string",
      "description": "Company CIK number"
    },
    "company_name": {
      "type": "string",
      "description": "Official company name"
    },
    "concept": {
      "type": "string",
      "description": "US-GAAP concept tag name"
    },
    "label": {
      "type": "string",
      "description": "Human-readable concept label"
    },
    "description": {
      "type": "string",
      "description": "Detailed concept description"
    },
    "annual_values": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "fiscal_year": {
            "type": "number",
            "description": "Fiscal year"
          },
          "period_end": {
            "type": "string",
            "description": "Period end date in YYYY-MM-DD format"
          },
          "value": {
            "type": "number",
            "description": "Reported value"
          },
          "filed": {
            "type": "string",
            "description": "Date filing was submitted"
          },
          "unit": {
            "type": "string",
            "description": "Unit of measurement (e.g., USD, shares)"
          }
        }
      },
      "description": "Annual values sorted by fiscal year descending"
    }
  },
  "required": [
    "cik",
    "company_name",
    "concept",
    "label",
    "description",
    "annual_values"
  ]
}

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_concept