# ZipRecruiter MCP MCP > The ZipRecruiter MCP lets your agent search millions of job listings instantly. You can filter roles by specific keywords, narrow down searches to exact locations or zip codes, and set minimum salary requirements—all without manually visiting a job board. It handles large result sets and focuses only on the freshest opportunities. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** job-search, hiring, recruitment, career, employment ## Description Need to research market rates or find candidates fast? This MCP connects your agent directly to ZipRecruiter's massive database, letting you talk through job searches like talking to an intern who knows everything. You simply tell it what you need—say, 'Project Manager roles in Seattle with a minimum salary of $120k posted this week.' The tool handles the filtering and pagination automatically. It’s built on Vinkius, which means when your agent uses credentials for this service, they pass through our zero-trust proxy. Your API key never sits on a disk; it only passes in transit. You get reliable job data without compromising security. This lets you analyze market trends or find specific roles by combining multiple MCPs—for example, chaining this with an internal CRM to immediately log the results into your pipeline. ## Tools ### ziprecruiter_search_jobs Searches ZipRecruiter for job openings based on filters like keywords, location, salary, and posting date. ## Prompt Examples **Prompt:** ``` Search for 'Software Engineer' jobs in Austin, Texas. ``` **Response:** ``` I've found several Software Engineer positions in Austin. Top results include roles at TechFlow and CloudScale. Would you like more details on any of these? ``` **Prompt:** ``` Find remote Marketing roles posted in the last 3 days with a minimum salary of 90000. ``` **Response:** ``` Searching... I found 3 remote Marketing positions posted recently that meet your salary criteria. Companies include GrowthLabs and BrandSync. Shall I list the full descriptions? ``` **Prompt:** ``` Show me the second page of 'Data Scientist' jobs in San Francisco. ``` **Response:** ``` Fetching the second page of results for Data Scientist roles in San Francisco... Here are the next 20 listings, including roles at InsightAI and DataCore. ``` ## Capabilities ### Search by Keywords Find job openings using specific titles or skill sets like 'Data Scientist' or 'Frontend Developer'. ### Filter by Location Limit results to precise cities, states, zip codes, and adjustable search radii. ### Refine by Salary Show only jobs that meet or exceed a specified minimum annual salary. ### Target Job Age Focus the results on opportunities posted within a defined number of days, ignoring stale listings. ### Paginate Results Handle large result sets by moving through pages and controlling how many listings appear at once. ## Use Cases ### A client needs local role examples The coach asks the agent to use `ziprecruiter_search_jobs` for 'UX Designer' in Portland, Oregon, limited to roles posted in the last 7 days. The agent returns a clean list of current opportunities, giving the client immediate options. ### Analyzing competitor hiring costs The HR manager runs several searches using `ziprecruiter_search_jobs`, varying only the salary floor (e.g., $100k vs $140k) for 'DevOps Engineer' in San Francisco to benchmark market pay ranges. ### Finding a niche contract role The user needs a short-term contractor and prompts the agent using `ziprecruiter_search_jobs` with keywords like 'consultant' and setting a low salary floor to find quick, temporary gigs. ### Benchmarking remote openings A recruiter uses `ziprecruiter_search_jobs`, filtering for 'Marketing Director' roles across multiple states while keeping the location filter set to 'Remote', comparing salaries easily. ## Benefits - Stop manually sifting through job boards. The `ziprecruiter_search_jobs` tool handles complex filtering—you can specify keywords, a zip code, and minimum salary all in one prompt. - Focus on the freshest listings. By filtering for jobs posted within specific days, you cut out stale or outdated roles that waste time. - Track market trends instantly. Recruiters can run bulk searches across different geographies to see if salaries are rising in a particular metro area. - Process huge result sets easily. The tool supports pagination controls, so you never have to worry about hitting a search limit when gathering data. - Pinpoint niche roles. You can combine keyword searching with salary refinement to find highly specific opportunities that meet your exact criteria. ## How It Works The bottom line is: Instead of clicking through five different websites to find jobs, you ask your agent one question and get structured data back. 1. Subscribe to this MCP on Vinkius and enter your ZipRecruiter API key. 2. Tell your agent what you need. Give it keywords, a location, or salary filters. 3. The tool returns the filtered job listings that match your criteria. ## Frequently Asked Questions **How does the ziprecruiter_search_jobs MCP handle complex filters?** It handles them by accepting multiple criteria (keywords, location, salary) in a single call. You don't have to run separate searches for each filter; it combines them. **Can I find jobs that are fully remote using ziprecruiter_search_jobs?** Yes. You can include 'Remote' in your keywords or use the location filtering options if they support a broad radius search. Always specify this to narrow results. **Does ziprecruiter_search_jobs find jobs that are already filled?** No, it focuses on actively listed opportunities. By specifying recency (e.g., posted in the last 7 days), you ensure the listings are current. **What if I want to check multiple salary ranges with ziprecruiter_search_jobs?** You can run separate calls, or structure your prompt to compare ranges. For example: 'Compare roles in Seattle at $100k vs $150k.' This lets you benchmark pay. **How do I authenticate my account when using the ziprecruiter_search_jobs MCP?** You must provide a valid ZipRecruiter API Key. Vinkius manages this key securely through a zero-trust proxy, meaning your credentials are used only in transit and never stored on disk. **If I run ziprecruiter_search_jobs and receive an error, how do I troubleshoot it?** The MCP generates a full audit trail every time a call is made. This tamper-proof log contains the SHA-256 hash chain, letting you pinpoint if the failure originated from invalid credentials or faulty search parameters. **How efficiently does ziprecruiter_search_jobs handle massive result sets?** It includes pagination support. This mechanism lets your agent process very large volumes of job listings page by page, preventing connection overload and minimizing token consumption for you. **Can I connect any of my preferred agents to run ziprecruiter_search_jobs?** Yes. Once you subscribe through Vinkius, your agent—whether it’s Claude, Cursor, or Windsurf—can access this MCP from that single connection point. **Can I filter jobs by a specific minimum salary?** Yes! You can use the `refine_by_salary` parameter in the `search_jobs` tool to set a minimum annual salary floor for your results. **How do I search for jobs within a certain distance from my location?** When using `search_jobs`, provide a `location` and set the `radius_miles` parameter to your preferred distance (default is 25 miles). **Is it possible to see only the most recently posted jobs?** Absolutely. Use the `days_ago` parameter in the `search_jobs` tool to limit results to jobs posted within the last N days.