Sec Xbrl

live FinanceGovernment

SEC EDGAR XBRL API — retrieve structured financial facts, track any XBRL metric over time, and get high-level annual financial summaries for public US companies.

8 tools
0ms auth
free tier 50 calls/day

Tools

get_company_facts

List all XBRL taxonomies and concept tags filed by a company (CIK required). Returns entity name, taxonomy names (us-gaap, dei, etc.), concept count per taxonomy, and a sample of up to 20 tag names ea

No parameters required.

▶ Try it
get_company_concept

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

No parameters required.

▶ Try it
search_filings

Search recent SEC filings for a company by CIK. Optionally filter by filing type (10-K, 10-Q, 8-K, etc.). Returns filing dates, types, and accession numbers.

No parameters required.

▶ Try it
get_company_financials

High-level summary of a public US company's annual (10-K) financials: revenue, net income, total assets, cash, EPS, etc. Returns clean numerical values with the XBRL tag used and the period-end date.

No parameters required.

▶ Try it
get_liquidity_runway

Estimate a company’s mechanical liquidity runway from its latest SEC-tagged cash/current investments and trailing-twelve-month operating cash flow. This is a screening calculation—not management guida

No parameters required.

▶ Try it
get_dilution_profile

Summarize SEC-tagged common shares outstanding, approximate year-over-year share change, and reported equity issuance proceeds. Share-count dates need not equal quarter end, tags vary by filer, and th

No parameters required.

▶ Try it
get_rnd_burn_profile

Calculate trailing-twelve-month SEC-tagged R&D expense and operating cash flow using annual plus current YTD minus prior-year comparable YTD. Returns the periods used and null when a defensible bridge

No parameters required.

▶ Try it
get_capital_markets_filings

List recent SEC capital-markets filings (S-1/S-3, 424B prospectuses, FWP, EFFECT, and amendments) for a company. A registration or prospectus filing does not prove securities were sold or quantify rem

No parameters required.

▶ Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash 
curl -X POST https://gateway.pipeworx.io/sec-xbrl/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash 
curl -X POST https://gateway.pipeworx.io/sec-xbrl/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_company_facts","arguments":{}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript 
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("get_company_facts", {});
ask_pipeworx 
// Or ask in plain English:
const answer = await px.ask("sec edgar xbrl api — retrieve structured financial facts, track any xbrl metric over time, and get high-level annual financial summaries for public us companies");