Skip to main content
MCP server CX Codex

bls-labor-mcp-server — Claude Code MCP server

bls-labor-mcp-server connects AI coding agents to US Bureau of Labor Statistics metrics like CPI, wages, and unemployment. Useful for economic research and automated data analysis.

no license 1,334 installs ★ 2 updated 2026-10-19

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http bls-labor-mcp-server https://bls-labor-mcp-server--cyanheads.run.tools
Open on GitHub

What bls-labor-mcp-server does

The server exposes BLS survey catalogs and time-series data directly to the agent. Using bls_search_series, you can locate specific economic series by natural language descriptions or geography without knowing BLS SeriesIDs in advance. Fetching historical numbers happens via bls_get_series, which accepts up to 50 series spanning a 20-year window in a single API round-trip.

Setting CANVAS_PROVIDER_TYPE=duckdb enables dataframe support with bls_dataframe_describe and bls_dataframe_query. This allows running analytical SQL queries, CTEs, and joins across fetched tables.

Without the DuckDB canvas provider configured, running large multi-series queries returns a canvas_unavailable message and requires narrowing the year window.

What it helps with

  • search BLS series identifiers using plain text keywords
  • retrieve up to 20 years of historical economic data in a single call
  • inspect recent inflation or unemployment observations
  • execute SQL queries and joins on retrieved economic dataframes

Example prompts for the agent

  • Find the SeriesID for the Consumer Price Index using bls_search_series
  • Pull the last 15 years of unemployment data with bls_get_series
  • Run a SQL aggregate on the registered BLS table using bls_dataframe_query

How to install bls-labor-mcp-server

Platform CLI: remote server

claude mcp add --transport http bls-labor-mcp-server https://bls-labor-mcp-server--cyanheads.run.tools

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about bls-labor-mcp-server

How to install bls-labor-mcp-server in Claude Code?

Run claude mcp add --transport http bls-labor-mcp-server https://bls-labor-mcp-server--cyanheads.run.tools.

What does bls-labor-mcp-server do?

It connects assistants to US Bureau of Labor Statistics data, handling series discovery, historical metrics retrieval, and SQL queries over results.

Does bls_search_series consume BLS API quota?

It searches an offline LABSTAT index, preserving API quota while resolving series IDs and coverage metadata.

Similar MCP servers

All MCP servers for Data and databases →

Project sponsors

Companies that keep this analytics open