H1B Sponsor MCP
ujjwalredd/H1B-Sponsor-MCP
Query dados USCIS H-1B: patrocinadores, aprovações e tendências por setor/estado
Ver no GitHubServidor MCP que fornece dados de empregadores patrocinadores de visto H-1B da USCIS, incluindo histórico de patrocínios, dados de processos e insights sobre elegibilidade. Consulte informações sobre mais de 1 milhão de registros de empregadores de 2009 a 2026.
Instalação
npx convez-ai ujjwalredd/H1B-Sponsor-MCP1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Pesquisar histórico de patrocínio H-1B de empresas específicas
- Analisar tendências de aprovação por estado, setor ou ano fiscal
- Identificar maiores patrocinadores e rankings por taxa de aprovação
- Validar elegibilidade de empregadores para patrocínio H-1B
Veredito

Ferramenta especializada e bem documentada para consultar dados públicos USCIS H-1B. Útil para pesquisadores, candidatos e empresas que precisam validar informações de patrocínio, mas nicho específico ao ecossistema de imigração nos EUA.
README
A tradução para o português deste README ainda está na fila.
H1B Sponsor MCP
Read-only MCP server for querying H-1B sponsoring employers from the USCIS Employer Information dataset.
Repository: https://github.com/ujjwalredd/H1B-Sponsor-MCP.git

This server lets MCP clients answer questions like:
- "Does Stripe appear in the H-1B employer data?"
- "Which companies had the most H-1B approvals in Texas in FY2024?"
- "How did manufacturing sponsorship change from FY2009 to FY2026?"
The bundled cleaned dataset covers fiscal years 2009-2026 with 1,055,650 employer-year/location records and 392,843 distinct employer name strings. FY2026 is a partial year.
What It Provides
| Tool | Purpose |
|---|---|
search_employers | Find employers by partial name, with lifetime totals |
employer_profile | Get year-by-year approvals, denials, locations, and sectors for matching employers |
top_sponsors | Rank sponsors by approvals, denials, petitions, approval rate, new employment approvals, or continuation approvals |
yearly_trends | Return per-year totals from FY2009-FY2026, optionally filtered by state or NAICS sector |
industry_breakdown | Summarize sponsorship by NAICS sector |
state_breakdown | Summarize sponsorship by US state or territory |
dataset_info | Return dataset coverage, row counts, and caveats |
Quick Start
uvx can fetch and run the server directly from
GitHub:
uvx --from git+https://github.com/ujjwalredd/H1B-Sponsor-MCP.git h1b-sponsor-mcp
After the package is published to PyPI, this shorter form should also work:
uvx h1b-sponsor-mcp
Install uv if needed:
curl -LsSf https://astral.sh/uv/install.sh | sh
Claude Code
claude mcp add h1b-sponsors -- uvx --from git+https://github.com/ujjwalredd/H1B-Sponsor-MCP.git h1b-sponsor-mcp
Claude Desktop
Add this server to claude_desktop_config.json:
{
"mcpServers": {
"h1b-sponsors": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/ujjwalredd/H1B-Sponsor-MCP.git",
"h1b-sponsor-mcp"
]
}
}
}
Manual Install
git clone https://github.com/ujjwalredd/H1B-Sponsor-MCP.git
cd H1B-Sponsor-MCP
python -m pip install -e .
h1b-sponsor-mcp
The cleaned parquet is included in the package. To use a different cleaned dataset file:
export H1B_DATA_PATH=/path/to/h1b_employers_clean.parquet
H1B_DATA_PATH must point to a .parquet file.
Data
- Source: USCIS H-1B Employer Data Hub, Employer Information exports.
- Coverage: fiscal years 2009-2026.
- Packaged file:
src/h1b_mcp/data/h1b_employers_clean.parquet. - Details: see DATA.md.
Recommended source citation:
U.S. Citizenship and Immigration Services (USCIS). H-1B Employer Data Hub, Employer Information exports. https://www.uscis.gov/tools/reports-and-studies/h-1b-employer-data-hub
This project is independent and is not affiliated with, sponsored by, or endorsed by USCIS, DHS, or the U.S. Government. The source data comes from a U.S. federal government publication; U.S. Government works are generally not copyright-protected in the United States under 17 U.S.C. Section 105. This is a practical attribution note, not legal advice.
Important caveats:
- FY2026 is partial.
- Counts are petitions, not unique workers.
- Employer names are not entity-resolved; the same company may appear under multiple spellings or legal names.
approval_rateisapprovals / (approvals + denials).- This project is an information tool, not legal or immigration advice.
Security Model
This server is intentionally narrow:
- stdio transport by default; no network listener is opened by this package.
- Read-only data access; no mutating MCP tools.
- No SQL,
eval,exec, pickle loading, or shell execution. - User search text is escaped before regex matching.
- Years, states, NAICS sectors, sort metrics, and limits are validated before the data layer runs.
- Results are hard-capped to protect client context windows.
- Errors returned to clients are sanitized; stack traces stay in stderr logs.
See SECURITY.md for the full policy and vulnerability reporting instructions.
Development
python -m pip install -e ".[dev]"
pytest
ruff check src tests
For quick local test runs without installing the editable package:
PYTHONPATH=src pytest
Run the MCP inspector:
mcp dev src/h1b_mcp/server.py
Open Source
- Contributions: CONTRIBUTING.md
- Code of conduct: CODE_OF_CONDUCT.md
- Support: SUPPORT.md
- Security: SECURITY.md
- Notice and attribution: NOTICE.md
- License: MIT
The source code is MIT licensed. Retain USCIS attribution when redistributing the packaged or derived data files.