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
claude mcp add --transport http bls-labor-mcp-server https://bls-labor-mcp-server--cyanheads.run.toolsWhat 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.toolsPlatform CLI: remote server
codex mcp add bls-labor-mcp-server --url https://bls-labor-mcp-server--cyanheads.run.toolsConfig file
{
"mcpServers": {
"bls-labor-mcp-server": {
"url": "https://bls-labor-mcp-server--cyanheads.run.tools"
}
}
}Config file
{
"servers": {
"bls-labor-mcp-server": {
"type": "http",
"url": "https://bls-labor-mcp-server--cyanheads.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http bls-labor-mcp-server https://bls-labor-mcp-server--cyanheads.run.toolsStep 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.