H1B Job Search MCP Server
An MCP (Model Context Protocol) server that automates H-1B job searching using REAL U.S. Department of Labor LCA disclosure data. Built with FastMCP.
🚀 Live Server: https://h1b-job-search-mcp.onrender.com/mcp
Power your agent
Instal dari penerbit. Bukan endpoint PlugMCP.
URL remote atau perintah di mesin Anda? Perbedaan kedua cara instal
Jalankan di PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
BukaDari penerbit
An MCP (Model Context Protocol) server that automates H-1B job searching using REAL U.S. Department of Labor LCA disclosure data. Built with FastMCP.
🚀 Live Server: https://h1b-job-search-mcp.onrender.com/mcp
An MCP (Model Context Protocol) server that automates H-1B job searching using U.S. Department of Labor LCA disclosure data.
Note: Due to limitation of memory on the free instance, the server tends to go down. I'm happy to accept server donations for hosting.
This server fetches actual H-1B application data directly from the U.S. Department of Labor's official disclosure files. Each dataset contains tens of thousands of real H-1B applications with:
For detailed usage examples and natural language prompts, see the Usage Guide.
Just talk naturally! The ask tool understands plain English:
load_h1b_dataDownload and load H-1B LCA data from the Department of Labor.
year: Fiscal year (default: 2024)quarter: Quarter 1-4 (default: 4)force_download: Force re-download even if cachedsearch_h1b_jobsSearch for H-1B sponsoring companies by job role and location.
job_role: Job title to search (e.g., "Software Engineer")city: Work city (optional)state: Work state code (optional, e.g., "CA")min_wage: Minimum wage filter (optional)max_results: Maximum results to returnskip_agencies: Skip staffing agencies (default: true)get_company_statsGet detailed H-1B sponsorship statistics for a specific company.
company_name: Company name to analyzeget_top_sponsorsList top H-1B sponsoring companies by application volume.
limit: Number of companies to returnexclude_agencies: Exclude staffing agenciesexport_resultsExport filtered H-1B results to a CSV file.
job_role: Job title to filtercity: City filter (optional)state: State filter (optional)filename: Output filenamemax_results: Maximum results to exportget_available_dataCheck available LCA data periods and cached files.
ask (Natural Language Interface) 🎯Talk to the H-1B search in simple English!
git clone <your-repo-url>
cd mcp-server-template
conda create -n h1b-mcp python=3.13
conda activate h1b-mcp
pip install -r requirements.txt
# Terminal 1: Start the server
python src/server.py
# Terminal 2: Run the inspector
npx @modelcontextprotocol/inspector
Open http://localhost:3000 and connect to http://localhost:8000/mcp using "Streamable HTTP" transport.
Load the data:
Tool: load_h1b_data
Parameters: {"year": 2024, "quarter": 4}
Search for jobs:
Tool: search_h1b_jobs
Parameters: {
"job_role": "Software Engineer",
"state": "CA",
"min_wage": 120000,
"skip_agencies": true
}
Get company details:
Tool: get_company_stats
Parameters: {"company_name": "Google"}
Export results:
Tool: export_results
Parameters: {
"job_role": "Data Scientist",
"state": "NY",
"filename": "ny_data_scientists.csv"
}
Click the "Deploy to Render" button above.
render.yaml configurationYour server will be available at https://your-service-name.onrender.com/mcp
Current deployment: https://h1b-job-search-mcp.onrender.com/mcp
This MCP server works with multiple LLM platforms. For detailed integration instructions, see docs/LLM_INTEGRATION.md.
{
"mcpServers": {
"h1b-search": {
"command": "python",
"args": ["/path/to/src/server.py"]
}
}
}
Run server with PORT=8000 python src/server.py and use the OpenAPI schema in config/openai_config.json.
Configure with function declarations using config/gemini_config.json.
Place config/cursor_config.json in .cursor/mcp-config.json and reload.
Use config/poke_config.json in Poke settings.
See docs/LLM_INTEGRATION.md for complete setup guides, testing procedures, and troubleshooting.
This tool uses publicly available LCA disclosure data from the U.S. Department of Labor's Foreign Labor Certification Data Center. The data includes:
Note: This data shows historical H-1B sponsorship patterns. Always verify current sponsorship policies with employers directly.
Add custom filtering logic or additional tools by modifying src/server.py:
@mcp.tool
def custom_analysis(parameter: str) -> dict:
"""Your custom H-1B data analysis."""
# Your implementation here
pass
nrows parameter in pandasdata_cache directory to force fresh downloadsFeel free to submit issues and pull requests to improve this tool!
MIT
An MCP (Model Context Protocol) server that automates H-1B job searching using U.S. Department of Labor LCA disclosure data.
Tool
Belum ada daftar tool. Server remote mendapatkannya setelah pemeriksaan kesehatan pertama.
FAQ
Salin konfigurasi stdio untuk Cursor, Claude Desktop, Claude Code, atau VS Code di halaman ini. Konfigurasi ini memakai instalasi dari penerbit, bukan proxy PlugMCP.
Tidak ada variabel lingkungan wajib yang tercantum di catatan ini.
H1b Job Search berjalan secara lokal melalui stdio.
Terakhir diperiksa 2026-10-27. An MCP (Model Context Protocol) server that automates H-1B job searching using U.S. Department of Labor LCA disclosure data.