BLS OEWS MCP

by 1102tools

483 downloads
Not rated
GitHub

About

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.

Details

Author
1102tools
Downloads
483
Categories
Other

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name BLS OEWS MCP
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

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"
        }
    }
}

BLS OEWS MCP

A Model Context Protocol server that wraps the BLS Occupational Employment and Wage Statistics API as deterministic tool calls. Built for IGCE developers, contract price analysts, HR compensation teams, federal labor cost benchmarkers, and anyone who needs market wage data tied to SOC codes and geography. 7 tools covering ~830 occupations across 530+ metro areas. Hardened across multiple live audit rounds. MIT licensed. Optional BLS API key (works without at reduced rate limits).
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.