H1B Job Search MCP Server

# H-1B Job Search MCP: Usage Guide 🎯 Welcome to the **H-1B Job Search MCP**! This guide will help you find H-1B sponsoring companies through simple, natural conversations with your AI assistant. ## 🚀 Quick Start The H-1B Job Search MCP understands natural language! Just tell it what you want in plain English. Here are the most common things people ask: ### 1. Getting Started - Load the Data ``` "Load the latest H-1B data" "Get me the 2024 Q4 H-1B data" "Download fresh H-1B sponsor data" ``` Your AI will respond with: ``` ✅ Successfully loaded 100,000 H-1B records from 2024 Q4 📊 Data cached for faster future searches 💡 Ready to search! Try: "Find software engineer jobs in California" ``` ### 2. Finding Your Dream Job #### Basic Job Search ``` "Find software engineer jobs" "Show me data scientist positions" "I'm looking for product manager roles" ``` #### Location-Specific Search ``` "Find software engineer jobs in San Francisco" "Show me tech jobs in Seattle, WA" "I want data analyst positions in New York City" ``` #### With Salary Requirements ``` "Find software engineer jobs paying over $150,000" "Show me data scientist roles in California with minimum $120k salary" "I need tech jobs in Austin paying at least $100,000" ``` #### Excluding Staffing Agencies ``` "Find direct hire software engineer positions (no agencies)" "Show me companies directly hiring data scientists, skip the consultancies" "I want product manager jobs but not from staffing companies" ``` ### 3. Researching Companies ``` "Tell me about Google's H-1B sponsorships" "How many H-1B visas does Microsoft sponsor?" "What positions does Apple typically sponsor?" "Show me Amazon's H-1B statistics" ``` Your AI will provide: ``` 📊 Google H-1B Statistics: - Total Applications: 1,234 - Certified: 1,200 (97.2%) - Top Positions: Software Engineer, Data Scientist, Product Manager - Salary Range: $120,000 - $350,000 - Average Salary: $185,000 - Top Locations: Mountain View (CA), New York (NY), Seattle (WA) ``` ### 4. Finding Top Sponsors ``` "Who are the top H-1B sponsors?" "Show me the top 20 companies sponsoring H-1B" "Which companies sponsor the most H-1B visas (not agencies)?" ``` ### 5. Exporting Your Results ``` "Export software engineer jobs in California to a spreadsheet" "Save my search results for data scientist jobs to CSV" "Create an Excel file with all Python developer positions" ``` ## 💬 Natural Language Examples The H-1B MCP is smart enough to understand various ways of asking for the same thing: ### Different Ways to Search for Jobs All of these work: - "I'm a software engineer looking for jobs in the Bay Area" - "Help me find SWE positions in Silicon Valley" - "software developer opportunities san francisco" - "coding jobs near San Jose, California" - "I want to work as a programmer in the Bay Area" ### Different Ways to Filter These all do the same thing: - "...paying over 150k" - "...with salary above $150,000" - "...minimum compensation 150000" - "...at least 150K per year" ### Different Ways to Exclude Agencies All of these skip staffing companies: - "...no agencies" - "...direct hire only" - "...skip consultancies" - "...not from staffing firms" - "...avoid Infosys, TCS, Wipro" ## 📋 Complete Workflow Examples ### Example 1: Fresh Graduate Software Engineer ``` You: "I'm a new CS grad looking for entry-level software engineer jobs" AI: Loading H-1B data... You: "Show me junior developer positions in Texas" AI: Found 145 companies sponsoring entry-level developers in Texas: 1. Dell Technologies - Austin, TX - $85,000-$95,000 2. Texas Instruments - Dallas, TX - $80,000-$90,000 3. Oracle - Austin, TX - $90,000-$100,000 ... You: "Tell me more about Dell's H-1B program" AI: Dell Technologies H-1B Statistics: - 89 H-1B applications - 85 certified (95.5%) - Top roles: Software Engineer, Systems Engineer, Data Analyst - Average salary: $92,000 - Primary location: Austin, TX You: "Export these Texas junior developer jobs to a file" AI: ✅ Exported 145 results to 'h1b_texas_junior_dev.csv' ``` ### Example 2: Experienced Data Scientist ``` You: "I'm a senior data scientist with 8 years experience, looking for high-paying roles" AI: Loading H-1B data... You: "Find data scientist positions paying over $180,000, no agencies" AI: Found 67 companies offering $180k+ for data scientists: 1. Google - Mountain View, CA - $200,000-$350,000 2. Meta - Menlo Park, CA - $195,000-$320,000 3. Netflix - Los Gatos, CA - $250,000-$400,000 ... You: "Which of these companies sponsor the most data scientists?" AI: Top data scientist sponsors (from your filtered list): 1. Google - 145 data scientist H-1Bs 2. Meta - 98 data scientist H-1Bs 3. Microsoft - 87 data scientist H-1Bs You: "Save this list for me" AI: ✅ Exported 67 high-paying data scientist positions to 'senior_data_scientist_180k.csv' ``` ### Example 3: Specific City Job Hunt ``` You: "I want to move to Seattle for a tech job" AI: Loading H-1B data... You: "What tech companies in Seattle sponsor H-1B?" AI: Major H-1B sponsors in Seattle: 1. Amazon - 2,341 applications 2. Microsoft - 1,876 applications 3. Expedia - 234 applications 4. Zillow - 156 applications 5. Tableau - 143 applications ... You: "Show me software engineer jobs at these companies" AI: Software Engineer positions in Seattle: - Amazon: 453 positions, $120k-$185k avg - Microsoft: 387 positions, $115k-$175k avg - Expedia: 45 positions, $110k-$155k avg ... You: "Which one has the best approval rate?" AI: H-1B Approval Rates (Seattle tech companies): 1. Microsoft: 98.2% approval rate 2. Amazon: 96.5% approval rate 3. Tableau: 95.8% approval rate ``` ## 🎯 Pro Tips for Better Results ### 1. Be Specific About Your Role Instead of: "tech jobs" Try: "backend engineer", "iOS developer", "machine learning engineer" ### 2. Use Standard Job Titles The database uses common titles like: - Software Engineer (not "Coder") - Data Scientist (not "Data Wizard") - Product Manager (not "Product Owner") ### 3. Specify Exact Locations When Possible - Use state codes: "CA", "NY", "TX" - Major cities work great: "San Francisco", "New York", "Austin" ### 4. Chain Your Searches Start broad, then narrow: 1. "Show me all data science jobs" 2. "Filter those for California" 3. "Now show only those paying over $150k" 4. "Remove staffing agencies" ### 5. Research Before Applying Always check: - Company's H-1B approval rate - Average salaries for your role - Number of similar positions sponsored - Primary office locations ## 🔍 Understanding the Results ### What the Data Shows You **For Job Searches:** - Company name (actual employer) - Job title (as filed with Department of Labor) - Location (city and state) - Wage information (when available) - Contact information (when available) **For Company Statistics:** - Total H-1B applications - Number of certified applications - Success rate percentage - Top job titles sponsored - Salary ranges and averages - Primary locations **For Top Sponsors:** - Ranking by volume - Total applications per company - Average wages offered - Primary state of operation ## 📊 Data Insights ### Best Times to Search - New quarter data becomes available ~45 days after quarter end - Q4 data (October-December) available in mid-February - Q1 data (January-March) available in mid-May ### Understanding Sponsors - **Direct Employers**: Companies hiring for their own teams - **Staffing Agencies**: Companies that place you at client sites - **Consultancies**: Mix of direct work and client placements ### Salary Expectations Salaries in the database are: - **Minimum wages** as per LCA requirements - Actual offers may be higher - Usually doesn't include bonuses/stock - Regional variations apply ## 🚫 Common Mistakes to Avoid ### ❌ Don't Do This: ``` "Show me all jobs" (too broad, will return too many results) "Find work" (too vague) "H1B" (need to specify what you want to know) ``` ### ✅ Do This Instead: ``` "Find software engineer jobs in California" "Show me data scientist positions paying over $120k" "Which companies sponsor the most H-1B visas?" ``` ## 🆘 Troubleshooting ### "No data loaded" **Solution:** First run: "Load the latest H-1B data" ### "No results found" **Try:** - Broader search terms: "engineer" instead of "senior backend engineer" - Different locations: "CA" instead of specific city - Remove filters: Try without salary requirements first ### "Too many results" **Try:** - Add location: "...in California" - Add salary filter: "...paying over $100k" - Exclude agencies: "...no staffing agencies" ## 🎓 Advanced Searches ### Combining Multiple Criteria ``` "Find machine learning engineer positions in California or Washington, paying over $150k, at companies that are not consultancies, and export the top 50 results" ``` ### Competitive Analysis ``` "Compare H-1B sponsorships between Google, Microsoft, and Amazon for software engineer positions" ``` ### Trend Analysis ``` "Show me how many data scientist H-1Bs were sponsored in Q1 vs Q2 vs Q3 vs Q4 of 2024" ``` ## 📝 Quick Reference Card | What You Want | What to Say | |--------------|-------------| | Load data | "Load H-1B data" | | Find jobs | "Find [job title] jobs" | | Add location | "...in [city/state]" | | Add salary | "...paying over $[amount]" | | Skip agencies | "...no agencies" | | Company info | "Tell me about [company] H-1B" | | Top sponsors | "Top H-1B sponsors" | | Export | "Export results to CSV" | ## 🎯 Your Journey Starts Here! 1. **Load the data**: "Load the latest H-1B data" 2. **Search for your role**: "Find [your job title] positions" 3. **Filter by location**: "...in [your preferred city]" 4. **Research companies**: "Tell me about [company name]" 5. **Export results**: "Save these results to a file" 6. **Apply strategically**: Use the data to focus on companies with high approval rates Remember: The H-1B MCP is here to help you make data-driven decisions in your job search. The more specific you are, the better results you'll get! Good luck with your H-1B job search! 🚀