# H1b [Health: Active]

**Category:** ⚖️ Legal  
**Repository:** https://github.com/pipeworx-io/mcp-h1b  
**GitHub Stars:** 0  
**npm Downloads (last month):** 1007  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/h1b

## Description
US H-1B visa sponsorship & LCA wage data — does a company sponsor, and what they pay per role

## Tools
Capabilities this server exposes over MCP:

- **h1b_employer_sponsorship** — Check whether a US employer sponsors H-1B visas and profile their sponsorship, from DOL Labor Condition Application (LCA) disclosures. Answers 'does company X sponsor H-1B / green cards' for recruiting and candidate advising. Returns the number of certified LCA filings, base-salary range (min / median / max), the top sponsored job titles, and top work locations for the employer. Filter by year (DOL federal fiscal year, Oct-Sep, for recent years); defaults to the latest full year. Employer name is matched as the disclosed legal name (e.g. 'Google', 'Amazon.com Services').
- **h1b_salary** — Look up real H-1B base salaries for a job title from DOL LCA disclosures — a market wage benchmark backed by actual filed salaries (not estimates). Answers 'what do H-1B software engineers earn at company X / in city Y'. Filter by job title, and optionally by employer, city, and year. Returns salary statistics (count, min / median / average / max) plus a sample of individual records (employer, title, salary, location, dates).
- **h1b_top_sponsors** — Find which US employers sponsor the most H-1B visas for a given job title (optionally in a specific city) — a candidate-sourcing / target-account signal for recruiting. Answers 'which companies sponsor the most data engineers in Austin' or 'top H-1B sponsors for nurses'. Returns employers ranked by certified LCA filings for the role, each with their filing count and median base salary. Backed by real DOL LCA disclosures.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "h1b": {
    "command": "npx",
    "args": ["-y","@pipeworx/mcp-h1b"]
  }
}
```

## Documentation

## What H1b does

H1b provides MCP tools for researching US H-1B sponsorship and wages from Labor Condition Application records. The data supports three related questions: whether an employer has sponsored H-1B workers, what disclosed base salaries look like for a role, and which employers file the most applications for a particular job title.

`h1b_employer_sponsorship` accepts an employer and optional year. It returns filing volume, salary-range information, and leading job titles and locations associated with matching employer records. Employer matching ranks exact names ahead of name-containing variants, and matching results identify the type of name match.

`h1b_salary` searches by job title and can narrow results by employer, city, year, and result limit. It returns salary statistics and sample disclosure records. `h1b_top_sponsors` ranks employers by filing count for a job title, optionally filtered by city and year, and includes median salary information.

## How it works

Recent federal fiscal years are served from DOL’s own LCA disclosure files. Older years, or requests outside the locally loaded range, can use h1bdata.info, a third-party aggregator of the same underlying DOL data. Responses identify the source that supplied the result and include a data timestamp or source-related status where applicable.

The local dataset treats `year` as a federal fiscal year, running from October 1 through September 30. The fallback service uses a different year-filtering convention, so an identical year value may not represent the same twelve-month period across both sources. This distinction is exposed in response notes rather than hidden.

Local ingestion converts wage values into annualized base salary using the filing’s pay unit: hourly, weekly, biweekly, monthly, or yearly. DOL records are loaded with an allowlist of non-personal fields. Employer names, employer location, job, wage, and worksite data are retained, while named employer contacts, attorneys, agents, and preparers are excluded.

## Tools and capabilities

- Check an employer’s H-1B filing count, salary range, common titles, and locations.
- Compare disclosed base salaries for a role across employers, cities, or years.
- Rank sponsors for a job title, with optional city and year filters.
- Use samples of underlying disclosure records alongside aggregate statistics.
- Distinguish DOL-mirror results from h1bdata.info fallback results.
- Avoid treating a database outage as evidence that an employer has no sponsorship: failed primary reads produce an indeterminate sponsorship value rather than a confident zero.

The local mirror avoids the raw-query row cap that can affect live aggregator searches, allowing sponsor rankings for DOL-served years to aggregate across all matching filings. Salary values still depend on the accuracy of the original filing; occasional wage-unit errors can produce implausible annualized figures. The records describe certified LCA filings, which are evidence of filings and disclosed wages rather than a guarantee of an eventual visa approval, hiring outcome, or green-card sponsorship.

_Full upstream README: https://allmcps.com/mcp/h1b/readme_