Skip to main content
ZipRecruiter MCP logo
  • Category: hr talent & recruitment
  • Auth: NO_AUTH
  • Composio-managed OAuth available? N/A
  • Tools: 1
  • Triggers: 0
  • Slug: ZIPRECRUITER_MCP
  • Version: 20260924_00

Tools

Slug: ZIPRECRUITER_MCP_SEARCH_JOBSUse this tool whenever the user asks to find, browse, view, recommend, or search for jobs, roles, openings, gigs, internships, or job listings. It only shows jobs that are within the United States or Canada. Guidelines:
  • Do not provide fields unless the user explicitly provides them.
  • The tool provides the search results all in one list, so if the user intends to search for multiple job roles, it may be better to invoke the tool for each job role separately.
  • If the user has not provided a location and is not asking for remote jobs, ask the user for a location before calling this tool. If you call without a location, results will default to a United States-wide search and the user will be warned.
Notes:
  • When provided radius_miles, jobs will be included in the result if their location’s boundaries approximately fall within radius miles of the requested location’s boundaries.
  • If a salary range is provided, a job will be included in the results if the job’s salary range overlaps with the requested salary range.

Input Parameters

number
Number of results to skip for pagination
array
Explicit skills mentioned by the user that are relevant to the job they’re looking for. Good example: ‘SQL’
string
Specific job role to search for. This can be omitted if the user’s intentions are to search broadly. Good example: ‘software engineer’, Bad example: ‘sitting job’
string
Concrete city, state, zip code, or address to search in. Good example: ‘Montreal, Quebec’, Bad example: ‘near me’
number
Maximum annual salary filter and must be greater than salary_min. MAX: 300000
number
Minimum annual salary filter. MIN: 0
number
Search radius in miles from the location.
array
The location type of the job.
array
The employment type of the job.
array
The seniority class of the job.
string
ISO-3166-1 alpha-2 country code. Only set this when a concrete location is provided and the country is known from that location. Must match the location that user wants to search in.
object
Any unsupported filters provided by the user. Good examples: 401K, benefits
number
Maximum number of minutes ago the job was posted. MIN: 1440

Output

object
required
Response metadata from the tool call
string ("OK" | "ERROR" | "NO_RESULTS" | "UNSUPPORTED_CONSTRAINTS" | "UNSUPPORTED_COUNTRY")
required
Response status of the tool call
object
required
Echo of the inputs provided to the tool call
array
List of matching job results
array
required
Note-worthy warnings encountered when executing the tool
string
Error message from the tool call if an error occurs