# Pay Bands

> Pay Bands is an open-source MCP server for hiring and recruiting. Look up published pay bands per seniority level, including markets with no posted range. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Repository:** https://github.com/dheerajjha/payband-mcp
- **MCP Registry name:** io.github.dheerajjha/payband-mcp
- **Categories:** [hiring and recruiting](https://ai-powered.com/categories/hiring-and-recruiting)
- **Listing updated:** 2026-11-18

## About

Pay laws in some US states require a salary range on covered job postings, while many other countries do not. The same role is often posted with a band in one city and without one in another. This server reads a company's public job-board data and reports the band per level, so an unpublished number can be anchored to the same employer's published one.

Output is split by seniority because one range across levels is a spread nobody is offered. The README treats the number of distinct bands against the number of postings as the real measure of evidence, since 58 postings sharing one band is one data point. A second view lists the same role across currencies with a dated conversion beside the published figure.

It reads documented job-board APIs from Greenhouse, Ashby, Lever, SmartRecruiters, Keka and Workday, plus a few employers' own endpoints. Google, Meta, Amazon and Apple are listed as not covered. Five Blind culture tools exist but are off unless enabled, because Blind began returning 403 to automated requests.

## Features

- **Per-level bands:** Typical band for each seniority with posting counts and a precision flag.
- **Cross-market view:** Same role in each posted currency with a dated conversion and ratio to the US band.
- **Employer comparison:** market_rate compares one level across several companies, sorted by midpoint.
- **Underlying postings:** job_openings returns the raw postings with inferred level.
- **Documented sources:** Reads public job-board APIs rather than scraping pages.
- **Honest gaps:** Unchecked postings are reported as not checked, not as no published range.

## Good for

- Estimate a salary for a role where the employer posts no range
- Compare the same level across several companies
- Check how much a company's pay differs between countries
- Sanity-check an offer against published bands

## Install

### Claude Code (Terminal)

```sh
claude mcp add payband-mcp -- uvx payband-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "payband-mcp": {
      "command": "uvx",
      "args": [
        "payband-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "payband-mcp": {
      "command": "uvx",
      "args": [
        "payband-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "payband-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "payband-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "payband-mcp": {
      "command": "uvx",
      "args": [
        "payband-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "payband-mcp": {
      "command": "uvx",
      "args": [
        "payband-mcp"
      ]
    }
  }
}
```

## Tools

- `pay_bands`: Published bands per seniority and per currency for a company and role
- `market_rate`: The same level across several employers, sorted by midpoint
- `job_openings`: The underlying postings with inferred level
- `find`: Search a company's Blind posts by keyword (off by default)
- `research`: Rank Blind threads against a question (off by default)
- `company_topics`: List Blind topics for a company (off by default)
- `company_posts`: List Blind posts for a company (off by default)
- `read_post`: Read a single Blind thread (off by default)

## FAQ

### Which job boards does it read?

Greenhouse, Ashby, Lever, SmartRecruiters, Keka and Workday, plus a small number of employers with their own endpoint.

### Which companies are not covered?

The README lists Google, Meta, Amazon, Apple and most Indian-headquartered companies.

### Are the Blind tools active?

Not by default; they need PAYBAND_ENABLE_BLIND=1, and Blind has been blocking automated requests since around September 2026.

### Was it renamed?

Yes, from blind-mcp in version 0.5.0; BLIND_MCP_* variables still work.

### Is Pay Bands free?

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

### How do I add Pay Bands to Claude Code?

Run this command in your terminal: claude mcp add payband-mcp -- uvx payband-mcp

### What are the best alternatives to Pay Bands?

The closest alternatives to Pay Bands are Reactive Resume, Joboracle, OnlineJobs.ph Scraper (Apify) - Philippine remote and VA jobs with wages, Gupy Jobs Scraper (Apify) - Brazil jobs with descriptions and Workday Jobs Scraper & API - All Companies, Last 24 Hours.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Reactive Resume](https://ai-powered.com/mcp/reactive-resume): Reactive Resume is an open-source MCP server for hiring and recruiting.
- [Joboracle](https://ai-powered.com/mcp/joboracle): Joboracle is a freemium MCP server for hiring and recruiting.
- [OnlineJobs.ph Scraper (Apify) - Philippine remote and VA jobs with wages](https://ai-powered.com/mcp/onlinejobs-ph-scraper-apify-philippine-remote-and-va-jobs-wi): OnlineJobs.ph Scraper (Apify) - Philippine remote and VA jobs with wages is a paid MCP server for web search and scraping.
- [Gupy Jobs Scraper (Apify) - Brazil jobs with descriptions](https://ai-powered.com/mcp/gupy-jobs-scraper-apify-brazil-jobs-with-descriptions): Gupy Jobs Scraper (Apify) - Brazil jobs with descriptions is a freemium MCP server for web search and scraping.
- [Workday Jobs Scraper & API - All Companies, Last 24 Hours](https://ai-powered.com/mcp/workday-jobs-scraper-and-api-all-companies-last-24-hours): Workday Jobs Scraper & API - All Companies, Last 24 Hours is a freemium MCP server for web search and scraping.
- [Lever Jobs Scraper & API - Salary, Remote, Last 24 Hours](https://ai-powered.com/mcp/lever-jobs-scraper-and-api-salary-remote-last-24-hours): Lever Jobs Scraper & API - Salary, Remote, Last 24 Hours is a paid MCP server for web search and scraping.
- [Workable Jobs Scraper & API - All Companies, Remote, 24 Hours](https://ai-powered.com/mcp/workable-jobs-scraper-and-api-all-companies-remote-24-hours): Workable Jobs Scraper & API - All Companies, Remote, 24 Hours is a freemium MCP server for web search and scraping.
- [Y Combinator Jobs Scraper & API - Work at a Startup, YC Jobs](https://ai-powered.com/mcp/y-combinator-jobs-scraper-and-api-work-at-a-startup-yc-jobs): Y Combinator Jobs Scraper & API - Work at a Startup, YC Jobs is a freemium MCP server for web search and scraping.

---
Source: https://ai-powered.com/mcp/pay-bands
