BLS

Provides access to U.S. labor market data from the BLS via MCP, including employment, CPI, wages, and industry statistics.
  • javascript

0

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "shawndrake2-mcp-bls": {
      "command": "node",
      "args": [
        "/path/to/bls/dist/index.js"
      ],
      "env": {
        "BLS_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You can access U.S. labor market data from the Bureau of Labor Statistics through a dedicated MCP server. This server lets you retrieve employment, unemployment, wage, CPI, and industry statistics in a structured way, enabling you to build dashboards, analytics, or automated reports using MCP clients.

How to use

Use a MCP client to connect to the BLS MCP server and run predefined tools that fetch time series data, CPI inflation categories, and employment statistics. You can query multiple series at once, explore common series IDs, and leverage shortcuts that return focused data sets such as unemployment, CPI categories, or employment by sector. Ensure you provide your API key securely to access BLS data.

How to install

Prerequisites you need before starting:

  • Node.js (LTS version recommended)

Create or prepare your MCP configuration for the BLS server using the example configuration provided here. Replace the placeholder path and API key with your actual values.

{
  "bls": {
    "command": "node",
    "args": ["/path/to/bls/dist/index.js"],
    "env": {
      "BLS_API_KEY": "your-api-key"
    }
  }
}

Additional notes

The BLS MCP server exposes a set of tools you can use to fetch and analyze labor statistics. You will need to supply a valid API key from the Bureau of Labor Statistics to access data.

Key environment variable you must provide: BLS_API_KEY. This key authenticates your requests to the data API.

Tools and endpoints

You have access to a set of tools to retrieve and interpret data. The primary tools are described below and can be used to construct queries against the BLS data portal.

Common series and shortcuts

The server includes shortcuts to fetch commonly requested data sets, such as unemployment rates, CPI indexes, and sector employment. You can also retrieve time series for specific items by providing the appropriate series IDs.

Examples of data you can query

  • Unemployment rate time series with national scope
  • CPI data by category such as food, housing, or medical care
  • Employment by major industry sectors over a date range
  • Quarterly Census of Employment and Wages (QCEW) data at employer or industry levels

Security and access

Keep your API key secure and do not commit it in code repositories. Use environment variables or secret management features provided by your deployment environment.

Available tools

query

Fetch BLS time series data for up to 50 series in a single request, including options for calculations and annual averages.

series_guide

Show common BLS series IDs and how to construct them for quick lookups.

get_cpi

Shortcut to fetch Consumer Price Index data, with options to select start/end years and CPI item categories.

get_unemployment

Shortcut to retrieve national unemployment rate data for a specified year range.

get_employment

Shortcut to obtain employment data by major industry sector over a given time period.

Built by
VeilStrat
AI signals for GTM teams
© 2026 VeilStrat. All rights reserved.All systems operational