git404hub

what is h1b-mcp fr?

blacksuan19/h1b-mcp — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · generalComplexity · 2/5LicenseSetup · easy

tl;dr

h1b-mcp is an MCP server that lets AI agents like Claude Code check a company's H-1B visa sponsorship history, salary data, and grade by scraping H1BGrader.

vibe map

mindmap
  root((h1b-mcp))
    What it does
      H-1B sponsorship lookup
      Scrapes H1BGrader
      Structured JSON output
    Tech stack
      Python
      MCP
      SeleniumBase
    Use cases
      Check company sponsorship
      Find sponsoring employers
      View salary and visa trends
    Audience
      Job seekers using AI assistants

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Ask an AI assistant whether a specific company sponsors H-1B work visas and see supporting evidence.

VIBE 2

Look up which employers most commonly sponsor a given job title or hire H-1B workers in a specific city.

VIBE 3

Pull historical H-1B approval, denial, and salary trends for a company through an AI agent conversation.

what's the stack?

PythonMCPSeleniumBase

how it stacks up fr

blacksuan19/h1b-mcp0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultyeasyhardhard
Complexity2/54/54/5
Audiencegeneraldeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Requires installing uv so uvx is available, then adding the server to your MCP-compatible client's config.

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

h1b-mcp is a server that gives AI coding agents, such as Claude Code or Codex, the ability to check whether a company sponsors H-1B work visas in the United States. It plugs in using the Model Context Protocol, a standard way for AI tools to call external services, and works by opening the H1BGrader website in a real browser, searching for a company, job title, or location, and pulling out the information shown there. This project is an independent community effort and is not affiliated with or endorsed by H1BGrader itself. Once connected, an agent can ask for a plain sponsorship signal like strong, mixed, weak, or no sponsor for a given company, along with supporting detail such as yearly visa application approval and denial counts, salary ranges, and an overall grade that H1BGrader assigns to that employer. The same kind of lookup also works for job titles and for specific cities, showing which employers most commonly sponsor that role or hire in that location. Results are cached locally so that asking about the same company again does not require reopening the browser and re-scraping the page. If the website blocks the automated browser or a lookup otherwise fails, the tool raises a clear error back to the agent rather than guessing or inventing an answer, so the agent knows the information could not be retrieved. Setting it up requires installing the uv Python tool so that its uvx command is available, then adding a short configuration snippet to your AI client of choice, such as Codex, Claude Desktop, Claude Code, or VS Code, pointing it at the published h1b-mcp package. Once configured and the client is restarted, you can simply ask your AI assistant something like whether a particular company sponsors H-1B visas, and it will call this tool automatically to answer. The project is released under the MIT license.

prompts (copy fr)

prompt 1
Add h1b-mcp to my Claude Code MCP config using uvx and confirm the server is running.
prompt 2
Check whether Databricks sponsors H-1B visas and show me the supporting evidence.
prompt 3
Get the top H-1B sponsoring employers for the job title data scientist.
prompt 4
Show annual H-1B salary history and approval trends for a company I'm considering.

Frequently asked questions

what is h1b-mcp fr?

h1b-mcp is an MCP server that lets AI agents like Claude Code check a company's H-1B visa sponsorship history, salary data, and grade by scraping H1BGrader.

What language is h1b-mcp written in?

Mainly Python. The stack also includes Python, MCP, SeleniumBase.

What license does h1b-mcp use?

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is h1b-mcp to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is h1b-mcp for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.