`company_financial_facts`

Pack: sec-financial-statements · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

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

Dimensioned XBRL facts for one filer — segment, geography or other axis breakdowns that data.sec.gov companyfacts/frames cannot return (those APIs expose undimensioned consolidated totals only). Give a company name (ILIKE match) or a CIK; optionally narrow to one tag (e.g. “Revenues”, “LongTermDebtNoncurrent”). Returns each fact’s period, value, unit, and — for a dimensioned fact — the segment/member axis it belongs to. Sourced from SEC DERA Financial Statement & Notes data sets, covering only the periods actually loaded (see fsn_coverage).

Parameters

Name	Type	Required	Description
`company`	string	no	Company name, matched with ILIKE (e.g. “Flutter Entertainment”). Omit if passing cik.
`cik`	string	no	SEC CIK, with or without leading zeros. Takes priority over company if both are given.
`tag`	string	no	Exact XBRL tag name to filter to, e.g. “DerivativeNotionalAmount” (case-sensitive).
`limit`	number	no	Max facts to return, 1-500 (default 100).

Example call

Arguments

{
  "company": "Apple",
  "tag": "Revenues"
}

curl

curl -X POST https://gateway.pipeworx.io/sec-financial-statements/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"company_financial_facts","arguments":{"company":"Apple","tag":"Revenues"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('company_financial_facts', {
  "company": "Apple",
  "tag": "Revenues"
});

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the sec-financial-statements pack

{
  "mcpServers": {
    "sec-financial-statements": {
      "url": "https://gateway.pipeworx.io/sec-financial-statements/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

company_financial_facts