# BLS OEWS

Gives agents access to bundled Occupational Employment and Wage Statistics market pay data via 8 tools without an API key.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 27
- Author: 1102tools-dev
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/1102tools-dev/federal-contracting-mcps/tree/HEAD/servers/bls-oews-mcp
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/bls-oews

## What it does

This server gives models direct access to Occupational Employment and Wage Statistics released by the US Bureau of Labor Statistics. The market wage dataset is packaged directly inside the distribution, which removes the need for any external API key.

It exposes 8 tools for looking up pay rates and occupational data. Running the server locally requires the `uvx` utility in your environment, though you can also connect to the hosted HTTP endpoint instead.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Remote server: `https://bls-oews.1102tools.com/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http bls-oews-mcp https://bls-oews.1102tools.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add bls-oews-mcp -- uvx bls-oews-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from bls-oews-mcp <command>

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add bls-oews-mcp --url https://bls-oews.1102tools.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add bls-oews-mcp -- uvx bls-oews-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from bls-oews-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "bls-oews-mcp": {
            "url": "https://bls-oews.1102tools.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "bls-oews-mcp": {
            "command": "uvx",
            "args": [
                "bls-oews-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from bls-oews-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "bls-oews-mcp": {
            "type": "http",
            "url": "https://bls-oews.1102tools.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "bls-oews-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "bls-oews-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from bls-oews-mcp <command>

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http bls-oews-mcp https://bls-oews.1102tools.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add bls-oews-mcp uvx bls-oews-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from bls-oews-mcp <command>

## When to use it
- look up market wage rates across labor categories
- retrieve BLS occupational employment statistics without an API key
- gather pay benchmarks for contract budget estimations

## Example prompts
- Look up the market wage figures for software engineers in BLS OEWS.
- Show occupational employment numbers and rates for technical writers.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16730
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40459
- [dbx](https://affpapa.org/en/nevibecode/mcp/dbx.md) — MCP server · ★ 27844
- [Metabase](https://affpapa.org/en/nevibecode/mcp/metabase.md) — MCP server · ★ 49863

From the same set: [1102tools-dev/federal-contracting-mcps](https://affpapa.org/en/nevibecode/by/1102tools-dev/federal-contracting-mcps.md) — 9 cards

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