edgar_company_concept

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

Track a specific financial metric over time for a company by CIK number (e.g., revenue, net income). Returns all reported values with dates and filing types.

Parameters

NameTypeRequiredDescription
cikstringyesCompany CIK number (e.g., “320193” for Apple)
conceptstringyesUS-GAAP concept name (e.g., “Revenue”, “NetIncomeLoss”, “Assets”, “Liabilities”, “StockholdersEquity”, “EarningsPerShareDiluted”)

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

FieldTypeDescription
cikstringCompany CIK number
company_namestringOfficial company name
conceptstringUS-GAAP concept tag name
labelstringHuman-readable concept label
descriptionstringDetailed concept description
annual_valuesarrayAnnual 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.

Regenerated from source · build May 9, 2026