`get_company_concept`

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

Get a specific financial metric for a company across all filings. Use this to track revenue, net income, or any XBRL tag over time. Example: get_company_concept(cik: “320193”, taxonomy: “us-gaap”, tag: “Revenue”).

Parameters

Name	Type	Required	Description
`cik`	string	yes	SEC Central Index Key (e.g., “320193” for Apple)
`taxonomy`	string	yes	XBRL taxonomy: “us-gaap”, “ifrs-full”, “dei”, or “srt”
`tag`	string	yes	XBRL concept tag (e.g., “Revenue”, “NetIncomeLoss”, “Assets”, “EarningsPerShareBasic”)

Example call

Arguments

{
  "cik": "320193",
  "taxonomy": "us-gaap",
  "tag": "Revenue"
}

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":"get_company_concept","arguments":{"cik":"320193","taxonomy":"us-gaap","tag":"Revenue"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('get_company_concept', {
  "cik": "320193",
  "taxonomy": "us-gaap",
  "tag": "Revenue"
});

More examples

{
  "cik": "789019",
  "taxonomy": "us-gaap",
  "tag": "NetIncomeLoss"
}

Response shape

Always returns: cik, entity_name, tag, taxonomy, label, description, units

Field	Type	Description
`cik`	number	SEC Central Index Key as numeric value
`entity_name`	string	Legal name of the company
`tag`	string	XBRL concept tag requested
`taxonomy`	string	XBRL taxonomy name
`label`	string	Human-readable label for the concept
`description`	string	Detailed description of the concept
`units`	object	Financial data grouped by unit (USD, shares, etc)

Full JSON Schema

{
  "type": "object",
  "properties": {
    "cik": {
      "type": "number",
      "description": "SEC Central Index Key as numeric value"
    },
    "entity_name": {
      "type": "string",
      "description": "Legal name of the company"
    },
    "tag": {
      "type": "string",
      "description": "XBRL concept tag requested"
    },
    "taxonomy": {
      "type": "string",
      "description": "XBRL taxonomy name"
    },
    "label": {
      "type": "string",
      "description": "Human-readable label for the concept"
    },
    "description": {
      "type": "string",
      "description": "Detailed description of the concept"
    },
    "units": {
      "type": "object",
      "description": "Financial data grouped by unit (USD, shares, etc)",
      "additionalProperties": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "value": {
              "type": "number",
              "description": "Reported numeric value"
            },
            "fiscal_year": {
              "type": "number",
              "description": "Fiscal year of the report"
            },
            "fiscal_period": {
              "type": "string",
              "description": "Fiscal period (e.g., FY, Q1, Q2)"
            },
            "period_end": {
              "type": "string",
              "description": "Period end date (ISO format)"
            },
            "filed": {
              "type": "string",
              "description": "Filing date (ISO format)"
            },
            "form": {
              "type": "string",
              "description": "SEC form type (10-K, 10-Q, etc)"
            }
          },
          "required": [
            "value",
            "fiscal_year",
            "fiscal_period",
            "period_end",
            "filed",
            "form"
          ]
        }
      }
    }
  },
  "required": [
    "cik",
    "entity_name",
    "tag",
    "taxonomy",
    "label",
    "description",
    "units"
  ]
}

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.

get_company_concept