# bls-labor-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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 1334 installs · ★ 2 repo stars
- Author: cyanheads
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cyanheads/bls-labor-mcp-server
- Updated: 2026-10-19
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/bls-labor-mcp-server

## What it 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.

## Requirements
- Remote server: `https://bls-labor-mcp-server--cyanheads.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http bls-labor-mcp-server https://bls-labor-mcp-server--cyanheads.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add bls-labor-mcp-server --url https://bls-labor-mcp-server--cyanheads.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "bls-labor-mcp-server": {
            "url": "https://bls-labor-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "bls-labor-mcp-server": {
            "type": "http",
            "url": "https://bls-labor-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http bls-labor-mcp-server https://bls-labor-mcp-server--cyanheads.run.tools
```

## When to use it
- 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
- 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

## Similar
- [BLS OEWS](https://affpapa.org/en/nevibecode/mcp/bls-oews.md) — MCP server · ★ 34 repo stars
- [karpathy-jobs-bls-visualizer](https://affpapa.org/en/nevibecode/skills/karpathy-jobs-bls-visualizer.md) — skill · 1300 installs
- [AgentEcon](https://affpapa.org/en/nevibecode/mcp/agentecon.md) — MCP server · 3813 installs
- [OECD MCP Server](https://affpapa.org/en/nevibecode/mcp/oecd-mcp-server.md) — MCP server · ★ 7 repo stars
- [data-analyst](https://affpapa.org/en/nevibecode/skills/borghei-data-analyst.md) — skill · 629 installs
- [AusEcon MCP - ABS RBA and APRA Data](https://affpapa.org/en/nevibecode/mcp/ausecon-mcp-abs-rba-and-apra-data.md) — MCP server · 932 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
