---
canonical_url: "https://docs.composio.dev/toolkits/ziprecruiter_mcp"
markdown_url: "https://docs.composio.dev/toolkits/ziprecruiter_mcp.md"
product: "platform"
version: null
last_updated: null
---

# ZipRecruiter MCP

Search job listings across ZipRecruiter's marketplace by role, location, and salary.

- **Category:** hr talent & recruitment
- **Auth:** NO_AUTH
- **Composio-managed OAuth available?** N/A
- **Tools:** 1
- **Triggers:** 0
- **Slug:** `ZIPRECRUITER_MCP`
- **Version:** 20260924_00

## Tools

### Search jobs

**Slug:** `ZIPRECRUITER_MCP_SEARCH_JOBS`

Use 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `offset` | number | No | Number of results to skip for pagination |
| `skills` | array | No | Explicit skills mentioned by the user that are relevant to the job they're looking for.  Good example: 'SQL' |
| `job_role` | string | No | 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' |
| `location` | string | No | Concrete city, state, zip code, or address to search in. Good example: 'Montreal, Quebec', Bad example: 'near me' |
| `salary_max` | number | No | Maximum annual salary filter and must be greater than salary_min. MAX: 300000 |
| `salary_min` | number | No | Minimum annual salary filter. MIN: 0 |
| `radius_miles` | number | No | Search radius in miles from the location. |
| `location_types` | array | No | The location type of the job. |
| `employment_types` | array | No | The employment type of the job. |
| `seniority_classes` | array | No | The seniority class of the job. |
| `country_admin_code` | string | No | 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. |
| `unsupported_filters` | object | No | Any unsupported filters provided by the user. Good examples: 401K, benefits |
| `max_posted_minutes_ago` | number | No | Maximum number of minutes ago the job was posted. MIN: 1440 |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `meta` | object | Yes | Response metadata from the tool call |
| `status` | string ("OK" | "ERROR" | "NO_RESULTS" | "UNSUPPORTED_CONSTRAINTS" | "UNSUPPORTED_COUNTRY") | Yes | Response status of the tool call |
| `request` | object | Yes | Echo of the inputs provided to the tool call |
| `results` | array | No | List of matching job results |
| `warnings` | array | Yes | Note-worthy warnings encountered when executing the tool |
| `errorMessage` | string | No | Error message from the tool call if an error occurs |