Economic Data

live Finance

US unemployment rate, CPI inflation, and employment figures from the Bureau of Labor Statistics

4 tools
0ms auth
free tier 50 calls/day

Tools

get_series required: series_id

Fetch a BLS time series by series ID. Returns data points with year, period, and value.

Parameters
Name Type Description
series_id req string BLS series ID (e.g. "CUUR0000SA0" for CPI)
start_year opt string Start year as 4-digit string (e.g. "2020"). Optional.
end_year opt string End year as 4-digit string (e.g. "2024"). Optional.
▶ Try it
get_unemployment

Get the US civilian unemployment rate over time (BLS series LNS14000000). Returns year, month, and rate for each period.

Parameters
Name Type Description
start_year opt string Start year as 4-digit string (e.g. "2020"). Optional.
end_year opt string End year as 4-digit string (e.g. "2024"). Optional.
▶ Try it
get_cpi

Get the US Consumer Price Index for All Urban Consumers (BLS series CUUR0000SA0). Returns year, month, and index value.

Parameters
Name Type Description
start_year opt string Start year as 4-digit string (e.g. "2020"). Optional.
end_year opt string End year as 4-digit string (e.g. "2024"). Optional.
▶ Try it
get_employment_by_industry

Get US non-farm payroll employment figures by industry. Options: "total_nonfarm", "manufacturing", "construction", "retail", "financial", "government". Returns employment in thousands.

Parameters
Name Type Description
industry opt string Industry to retrieve. One of: "total_nonfarm", "manufacturing", "construction", "retail", "financial", "government".
start_year opt string Start year as 4-digit string. Optional.
end_year opt string End year as 4-digit string. Optional.
▶ 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/econdata/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/econdata/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_series","arguments":{"series_id": "LNS14000000"}}}'

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_series", {"series_id":"example"});
ask_pipeworx 
// Or ask in plain English:
const answer = await px.ask("us unemployment rate, cpi inflation, and employment figures from the bureau of labor statistics");