MCP.so
Sign In

BLS OEWS MCP

@1102tools

About BLS OEWS MCP

MCP server for the BLS Occupational Employment and Wage Statistics API: ~830 occupations across 530+ metro areas with employment counts, mean/median wages, and full percentile distributions at national, state, and metro levels. 7 tools.

Basic information

Category

Other

Transports

stdio

Publisher

1102tools

Submitted by

James

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "bls-oews": {
      "command": "uvx",
      "args": [
        "--refresh-package",
        "bls-oews-mcp",
        "--from",
        "bls-oews-mcp",
        "bls-oews-mcp"
      ],
      "env": {
        "BLS_API_KEY": "your-key-here"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is BLS OEWS MCP?

A Model Context Protocol server that wraps the BLS Occupational Employment and Wage Statistics API as deterministic tool calls. It provides market wage data tied to SOC codes and geography for IGCE developers, contract price analysts, HR compensation teams, and federal labor cost benchmarkers.

How to use BLS OEWS MCP?

Install via uvx bls-oews-mcp or pip install bls-oews-mcp. Optionally set a BLS_API_KEY environment variable for higher rate limits. Configure in any MCP-compatible client (Claude Desktop, Codex, Gemini CLI, Copilot, Cursor, Cline, Zed, Continue) using the JSON or TOML config shown in the README.

Key features of BLS OEWS MCP

  • Search occupations by keyword or SOC code
  • Retrieve mean, median, and full percentile wage distributions
  • Filter wage data by geographic level and ownership type
  • Compare wages across multiple metros for one occupation
  • Compare multiple occupations in a single metro
  • Generate IGCE wage benchmarks with data vintage tracking
  • Detect the most current year of available BLS data

Use cases of BLS OEWS MCP

  • Build IGCEs grounded in real BLS market wage data
  • Cross-reference contractor proposed labor rates against market distributions
  • Federal labor cost analyses for budget submissions and program reviews
  • Geographic wage differential analysis across metro areas
  • Justify wage increases or labor category placements with documented market data

FAQ from BLS OEWS MCP

Do I need a BLS API key?

No, the server works without a key at reduced rate limits. An optional free key from the BLS registration engine gives 500 queries per day.

How current is the wage data?

BLS OEWS data is published annually with a typical 12–18 month lag. The server includes a detect_latest_year tool to check the most recent vintage available.

What tools are included?

Seven tools covering occupation search, wage data retrieval per SOC/geography, cross-geographic comparison (compare_metros, compare_occupations), an IGCE wage benchmark tool, and data vintage detection.

Is the server hardened for production use?

Yes, it has been live-audited against the production BLS endpoint across multiple rounds and handles rate limiting, MSA code variants, suppressed data flags, and schema drift.

Is this part of a larger suite?

Yes, it is part of the 1102tools suite which includes eight federal contracting MCPs and six Claude Skills.

Comments

More Other MCP servers