# BLS OEWS

> BLS OEWS is an open-source MCP server for analytics and data. U.S. occupational wage data bundled offline, for federal cost estimates, with no API key. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API
- **Website:** https://1102tools.com
- **Repository:** https://github.com/1102tools-dev/federal-contracting-mcps/tree/HEAD/servers/bls-oews-mcp
- **MCP Registry name:** com.1102tools/bls-oews-mcp
- **Categories:** analytics and data, legal and government
- **Listing updated:** 2026-11-14

## About

This server answers Occupational Employment and Wage Statistics questions from a bundled copy of the May 2025 estimates, which BLS published on May 15, 2026. Because the database ships inside the package, answers are local, need no key and have no daily limit. Each result cites the BLS release, publication date, retrieval date and source file.

It is aimed at federal contracting work such as independent government cost estimates and price analysis. The igce_wage_benchmark tool adds burdened rate estimates, while other tools compare metros or occupations. Where BLS publishes no number, the footnote is kept and a published alternative is suggested; top-coded wages keep BLS's lower bound and the server does not invent an exact wage or annualise hourly-only roles.

It is one of nine free servers from 1102tools under the MIT licence, available locally with uvx or hosted through the Claude and ChatGPT directories.

## Features

- **Bundled BLS data:** Ships the May 2025 OEWS estimates as a read-only database.
- **Cited answers:** Each result names the release, publication date, retrieval date and source file.
- **IGCE benchmarks:** Wage benchmarks with burdened rate estimates.
- **Metro and occupation comparisons:** Compare one occupation across metros or several occupations in one place.
- **Footnote handling:** Keeps BLS footnotes where no wage is published.
- **Local or hosted:** Run via uvx or use the hosted endpoint.

## Good for

- Build a labor-rate benchmark for a government cost estimate
- Compare wages for one role across metro areas
- Look up wages by SOC code for a state
- Find the SOC codes common to federal IT services
- Confirm which OEWS release is in use

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http bls-oews-mcp https://bls-oews.1102tools.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://bls-oews.1102tools.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "bls-oews-mcp": {
      "url": "https://bls-oews.1102tools.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "bls-oews-mcp": {
      "type": "http",
      "url": "https://bls-oews.1102tools.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "bls-oews-mcp": {
      "serverUrl": "https://bls-oews.1102tools.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "bls-oews-mcp": {
      "type": "http",
      "url": "https://bls-oews.1102tools.com/mcp"
    }
  }
}
```

## Tools

- `get_wage_data`: Wage statistics for an occupation by SOC code.
- `compare_metros`: Compare an occupation's wages across metros.
- `compare_occupations`: Compare wages across occupations in one location.
- `igce_wage_benchmark`: Wage benchmark with burdened rate estimate.
- `detect_latest_year`: Report the bundled OEWS data year and release.
- `list_common_soc_codes`: List SOC code mappings for federal IT services.
- `list_common_metros`: List metro area codes.
- `get_data_status`: Show the bundled release and source file details.

## FAQ

### Do I need an API key?

No, and there is no daily limit.

### Which data year is bundled?

The May 2025 OEWS estimates, published May 15, 2026.

### What happens when BLS has no wage figure?

The BLS footnote is kept and a published hourly or annual alternative is suggested.

### Is it free?

Yes, the 1102tools site describes it as free and MIT licensed.

### Is BLS OEWS free?

Yes. BLS OEWS is open source, so you can use and self-host it for free.

### How do I add BLS OEWS to Claude Code?

Run this command in your terminal: claude mcp add --transport http bls-oews-mcp https://bls-oews.1102tools.com/mcp

### What are the best alternatives to BLS OEWS?

The closest alternatives to BLS OEWS are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [NY LLC Publication (FileMyPublication)](https://ai-powered.com/mcp/ny-llc-publication-filemypublication): NY LLC Publication (FileMyPublication) is a free MCP server for legal and government.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/bls-oews
