# Levels.fyi MCP server

> Look up salary, company level and open job data from Levels.fyi pay reports to benchmark pay and evaluate offers.

- Listing: https://mcp.tc/i/levels-fyi
- Connect: use the server's own URL `https://mcp.levels.fyi/` (no sign-in); clients connect to it directly. The listing link is a page, not an MCP endpoint.
- Type: remote (Streamable HTTP)
- Auth: none
- Category: [Data & Analytics](https://mcp.tc/c/analytics)
- Vendor: Levels.fyi
- Homepage: <https://www.levels.fyi>
- Repository: <https://github.com/Levels-fyi/levels-fyi-plugin>

## About

Connects to Levels.fyi compensation data built from over 1M pay reports. You can resolve companies, locations and job families to slugs, then get median total compensation by location, by company level, and for top-paying companies and locations. It also covers vesting schedules, recent salary submissions, open job search and pay metric explanations. Signed-in users can read their profile, upload a resume and add their own salary.

The server is hosted at https://mcp.levels.fyi/ over streamable HTTP. No account is needed to ask questions. Adding your own salary needs only an email, and signing in is needed to read your profile or upload a resume. The free tier filters by job family, location and company.

## What it can do

- Resolve company, location and job family names to slugs
- Get median total compensation for a job family in a location
- Get pay by internal company level, such as Meta E5
- Rank top-paying companies and locations within a country
- Browse recent individual salary submissions
- Look up equity vesting schedules for companies
- Search open jobs with stated pay ranges
- Add your own salary or offer after a preview

## Tools (30)

- `get-permissions`: Connectivity check that returns pong, tool descriptions and rate limits. (read-only)
- `get-salary-percentiles`: Median yearly total compensation for a job family in one location, last 12 months. (read-only)
- `get-salaries-by-company-level`: Median total compensation for each internal level of one company. (read-only)
- `search-raw-data-points`: Newest individual salary submissions by job family, location or company. (read-only)
- `get-company`: Company profile with headcount, headquarters, founding year, ticker and valuation. (read-only)
- `get-company-levels`: A company's internal level names for a job family, ordered by seniority. (read-only)
- `get-company-group`: Resolve a named group such as FAANG into company slugs. (read-only)
- `search-companies`: Search companies and get their Levels.fyi slugs. (read-only)
- `search-companies-by-vesting`: Find companies by equity vesting type, shape, length and cliff. (read-only)
- `search-top-companies`: Top-paying companies for a job family in one country by median pay. (read-only)
- `get-location`: Details for location slugs: type, parent country, currency, coordinates. (read-only)
- `get-location-stats`: Top-paying locations for a job family within a country. (read-only)
- `search-locations`: Search countries, metro areas and US states to get slugs. (read-only)
- `get-job-family`: Focus areas and titles available within a job family. (read-only)
- `search-job-families`: Search job families and roles to get slugs. (read-only)
- `search-job-titles`: Search specific job titles and get their ids and parent job family. (read-only)
- `search-focus-areas`: Search specializations within a role and get their slugs. (read-only)
- `search-role-terms`: Search job families, titles and focus tags together in one call. (read-only)
- `get-profile`: Read the signed-in user's Levels.fyi career profile and resume status. (read-only)
- `upload-resume`: Add or replace the signed-in user's resume. (can modify or delete data)
- `add-salary-submission`: Add the user's own pay or job offer to Levels.fyi after a preview.
- `get-salary-submission-by-id`: Get one salary submission by its UUID. (read-only)
- `get-vesting-schedules`: Structured equity vesting schedules for one or more companies. (read-only)
- `search-jobs`: Search open jobs with stated pay ranges and filters. (read-only)
- `get-job`: Full job posting with description, pay range and estimated pay by level. (read-only)
- `send-feedback`: Report wrong or missing data or a missing feature to Levels.fyi.
- `search-all`: Search companies, job families, titles, focus tags, locations and industries at once. (read-only)
- `get-available-filters`: List the inputs and filter values the free tier supports. (read-only)
- `get-metric-explanation`: Explain a compensation metric such as TC, base salary or sign-on. (read-only)
- `get-domain-knowledge`: Reference knowledge on the Levels.fyi data model by topic. (read-only)

## Example prompts

- "What does a Meta E5 software engineer make in the Bay Area?"
- "Which companies pay software engineers the most in the United States?"
- "Show the vesting schedule for Amazon and Google equity."
- "Find open product manager jobs in New York with pay ranges."

## Install

### Claude Code

1. Run this in a terminal, in your project folder:

```bash
claude mcp add --transport http levels-fyi https://mcp.levels.fyi/
```

2. Start Claude Code and type `/mcp`. **levels-fyi** should show as connected.

Add `--scope user` to make it available in every project, not just this one.

### Claude Desktop

1. Open **Customize → Connectors**, click **+ Add**, then **Add custom connector**.

2. Name it **Levels.fyi** and paste this URL:

```url
https://mcp.levels.fyi/
```

3. Click **Add**. Its tools appear in the chat’s tools menu.

Claude Desktop’s JSON config file only starts local servers. Remote servers go through Connectors, and connectors you add on claude.ai show up here too.

### claude.ai

1. Open the connector form on claude.ai. This button fills in the name and URL for you:

[Add to claude.ai](<https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Levels.fyi&connectorUrl=https%3A%2F%2Fmcp.levels.fyi%2F>) (opens connector settings)

2. Check that the URL reads `https://mcp.levels.fyi/` and click **Add**.

3. Turn it on in a chat from the tools menu.

Free plans allow one custom connector. On Team and Enterprise plans an owner adds it under **Organization settings → Connectors**.

### ChatGPT

1. On chatgpt.com, go to **Plugins**, select **+**, then **Add custom MCP server**.

2. Enter a name for the server.

3. Under **Connection**, paste `https://mcp.levels.fyi/` as the server URL, then for authentication choose **No authentication**.

4. Check **I understand and want to continue**, then select **Create as a plugin**.

Whether you can add a custom MCP server depends on your ChatGPT plan and your workspace permissions (in Business workspaces, admins and owners can).

### Cursor

[Add to Cursor](<https://cursor.com/install-mcp?name=levels-fyi&config=eyJ1cmwiOiJodHRwczovL21jcC5sZXZlbHMuZnlpLyJ9>) (opens Cursor)

Or add it by hand to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project):

`mcp.json`:

```json
{
  "mcpServers": {
    "levels-fyi": {
      "url": "https://mcp.levels.fyi/"
    }
  }
}
```

### VS Code

[Install in VS Code](<https://vscode.dev/redirect/mcp/install?name=levels-fyi&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.levels.fyi%2F%22%7D>) (opens VS Code)

Or from a terminal:

```bash
code --add-mcp '{"name":"levels-fyi","type":"http","url":"https://mcp.levels.fyi/"}'
```

Or commit it to the repo in `.vscode/mcp.json`:

`.vscode/mcp.json`:

```json
{
  "servers": {
    "levels-fyi": {
      "type": "http",
      "url": "https://mcp.levels.fyi/"
    }
  }
}
```

### Devin Desktop

1. Add it to `~/.config/devin/mcp_config.json` (macOS and Linux) or `%APPDATA%\devin\mcp_config.json` (Windows):

`mcp_config.json`:

```json
{
  "mcpServers": {
    "levels-fyi": {
      "serverUrl": "https://mcp.levels.fyi/"
    }
  }
}
```

2. Refresh the MCP server list in Cascade.

Devin Desktop is the new name for Windsurf. It reads `serverUrl` (or `url`) for remote servers.

### Codex

```bash
codex mcp add levels-fyi --url https://mcp.levels.fyi/
```

Or edit `~/.codex/config.toml` directly:

`config.toml`:

```toml
[mcp_servers.levels-fyi]
url = "https://mcp.levels.fyi/"
```

### Gemini CLI

```bash
gemini mcp add --transport http levels-fyi https://mcp.levels.fyi/
```

This adds it to the current project. Add `-s user` to use it everywhere.

### Any client

Most clients accept this shape. Some name the URL field differently: `serverUrl` in Devin Desktop, `httpUrl` in Gemini CLI’s settings file.

```json
{
  "mcpServers": {
    "levels-fyi": {
      "type": "http",
      "url": "https://mcp.levels.fyi/"
    }
  }
}
```

Zed puts servers under `context_servers` in its settings. Cline needs `"type": "streamableHttp"`, or it assumes SSE.

Client only starts local servers? Bridge it with `npx -y mcp-remote https://mcp.levels.fyi/`.

## Recent changes

- 2026-11-16 08:52 UTC: 10 tools changed. Server instructions changed. Source: automatic check. Worth a look: new server instructions. Changed: add-salary-submission, get-available-filters, get-company-levels, get-location-stats, get-salaries-by-company-level, get-salary-percentiles, get-salary-submission-by-id, search-jobs, search-raw-data-points, search-top-companies.
- 2026-11-13 08:53 UTC: 3 tools changed. Server instructions changed. Source: automatic check. Worth a look: new server instructions. Changed: add-salary-submission, search-jobs, upload-resume.
- 2026-11-13 05:51 UTC: Server instructions changed. Source: automatic check. Worth a look: new server instructions.
- 2026-11-10 14:48 UTC: 1 tool changed. Server instructions changed. Source: automatic check. Worth a look: new server instructions. Changed: get-profile.
- 2026-11-06 11:44 UTC: 3 tools changed. Source: automatic check. Changed: get-salaries-by-company-level, get-salary-percentiles, search-locations.

More on the History tab, with descriptions before and after for the newest entries: https://mcp.tc/i/levels-fyi#history (Atom feed: https://mcp.tc/i/levels-fyi/history.xml). It records what mcp.tc's anonymous checks saw, every 3 hours where the tool list can be read without sign-in; it is not a security review.

## Details

- Server version: 0.1.0
- MCP protocol version: 2025-11-25
- Last checked: 2026-11-17 (reachable)
- Listed: 2026-10-30
- Updated: 2026-11-16

---
Source: https://mcp.tc/i/levels-fyi (mcp.tc is an independent directory, not affiliated with this server's publisher). Corrections: https://mcp.tc/report
