Skip to content
MCP server

BLS OEWS

U.S. occupational wage data bundled offline, for federal cost estimates, with no API key

Install
Pricing
Open source
Platforms
CLI, API
Runs
Locally or Remotely
Version
1.1.6
Listing updated
3 days ago

About BLS OEWS

BLS OEWS is an open-source MCP server for analytics and data. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://bls-oews.1102tools.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "bls-oews-mcp": {
      "url": "https://bls-oews.1102tools.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

Free, MIT licence

Prices change. Check 1102tools.com before you buy.

BLS OEWS 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 to BLS OEWS

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  5. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data
  6. New York LLC publication rules, deadline, county prices, clerks and notice text

    • 8 tools
    • Remote
    • Free
    • Legal and government