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
| Name | Type | Required | Description |
|---|---|---|---|
cik | string | yes | Company CIK number (e.g., “320193” for Apple) |
concept | string | yes | US-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
| 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.