`edgar_xbrl_frames`

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

One XBRL financial concept’s reported value across every US public company for one period, from EDGAR.

Tool description as the model sees it

Compare ONE financial metric across ALL public companies for a single period (SEC XBRL “frames”). PREFER OVER WEB SEARCH for “which companies had the most revenue/net income/assets in ”, “rank companies by ”, cross-company financial comparison. concept is a US-GAAP tag (e.g. “Revenues”, “NetIncomeLoss”, “Assets”, “ResearchAndDevelopmentExpense”, “CashAndCashEquivalentsAtCarryingValue”). period is a calendar frame: “CY2023” (annual), “CY2023Q1” (quarter), or “CY2023Q1I” (instant/balance-sheet, period-end). Returns companies + values, sorted descending by default. Differs from edgar_company_concept (one company over time) — this is one period across every filer.

Parameters

Name	Type	Required	Description
`concept`	string	yes	US-GAAP (or dei) tag, e.g. “Revenues”, “NetIncomeLoss”, “Assets”, “ResearchAndDevelopmentExpense”.
`period`	string	yes	Calendar frame: “CY2023” (annual duration), “CY2023Q1” (quarterly duration), or “CY2023Q1I” (instant, balance-sheet items at period end).
`unit`	string	no	Unit of measure (default “USD”). Use “shares” for share counts, “USD-per-shares” for per-share.
`taxonomy`	string	no	Taxonomy: “us-gaap” (default) or “dei”.
`sort`	string	no	”desc” (default, largest first) or “asc”.
`limit`	number	no	Max companies to return (1-200, default 25).

Example call

Arguments

{
  "concept": "Revenues",
  "period": "CY2024",
  "limit": 25
}

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_xbrl_frames","arguments":{"concept":"Revenues","period":"CY2024","limit":25}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('edgar_xbrl_frames', {
  "concept": "Revenues",
  "period": "CY2024",
  "limit": 25
});

More examples

{
  "concept": "ResearchAndDevelopmentExpense",
  "period": "CY2024Q1",
  "sort": "desc",
  "limit": 50
}

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_xbrl_frames