# Indeed MCP

> Indeed allows your AI agent to access millions of job listings directly from any MCP-compatible client. Use it to find roles by keyword, narrow results down to a specific city or zip code, and filter by employment type—whether you need full-time, contract, or internship positions. It’s a live job board feed built for your workflow.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** job-search, recruitment, hiring, career-opportunities, indeed-api

## Description

This connector lets you run deep, structured searches against Indeed's massive database without ever leaving your current workspace. Forget manually hopping between tabs and adjusting filters on the job site; simply ask your agent to find what you need.

Your AI client executes a search using keywords or company names and automatically handles location constraints, like limiting results to within 25 miles of an address. You can refine that initial list further by specifying job types—full-time, part-time, contract work—and sorting the output by date or relevance.

This capability is huge for recruiters who need fast market benchmarks, and equally useful for job seekers who want to automate their search process entirely within their development environment. It’s one of the core utilities housed in the Vinkius catalog that lets you treat a major external database like just another API call.

## Tools

### search_jobs
Runs a job search on Indeed using keywords, location details, and specific filters.

## Prompt Examples

**Prompt:** 
```
Search for 'Software Engineer' jobs in 'New York'.
```

**Response:** 
```
I found several Software Engineer positions in New York. The top results include roles at TechCorp and Innovate Solutions. Would you like to see more details for any of these?
```

**Prompt:** 
```
Find part-time 'Graphic Designer' roles within 25 miles of Austin.
```

**Response:** 
```
I've located 3 part-time Graphic Designer roles within 25 miles of Austin. They range from boutique agencies to larger firms. Should I list the specific requirements for the most recent one?
```

**Prompt:** 
```
Get the latest 'Data Scientist' job listings sorted by date.
```

**Response:** 
```
Here are the most recent Data Scientist listings, sorted by date. The newest post was added just 2 hours ago. Do you want to filter these by a specific job type?
```

## Capabilities

### Find jobs by keyword or company
You search for roles using specific titles, skills, or company names.

### Filter by location and radius
The tool restricts results to defined cities, states, or zip codes, respecting a configurable distance from that center point.

### Refine search by job type
You can narrow the list down to specific employment statuses like full-time, part-time, contract, or internship.

### Browse large result sets
The system handles pagination parameters, allowing your agent to efficiently look through massive collections of job listings.

## Use Cases

### A hiring manager needs a competitive analysis.
The manager asks the agent: 'Find me all 'Data Scientist' roles hired by competitors within 50 miles of Boston, filtered for salary.' The agent uses `search_jobs` to deliver structured data points immediately, allowing the manager to compare market rates in minutes.

### A student needs a niche internship.
The student asks: 'Search for part-time 'UX Designer' internships at non-profit organizations within 10 miles.' The agent uses `search_jobs` to filter by both job type and organization sector, giving the student highly relevant opportunities.

### An HR developer needs a data feed.
The developer tasks the agent: 'Run a comprehensive search for all contract roles in finance over the last month.' The agent uses `search_jobs` to pull results and format them into a structured JSON object, ready for import into their company's ATS.

## Benefits

- Instant Market Intelligence: Instead of manually checking multiple websites, you run `search_jobs` to instantly find active listings and understand market salaries for a role in a specific area. It's fast data gathering.
- Targeted Filtering: You don't have to wade through irrelevant results. By specifying filters like 'full-time' or 'internship,' your agent uses the `search_jobs` tool to pull only the listings you actually care about.
- Efficiency Over Browsing: This MCP eliminates the need for copy-pasting keywords into a web browser and clicking through multiple result pages. You just talk to your AI client, and it does the heavy lifting.
- Handle Massive Data Sets: The tool supports pagination, meaning if you're tracking roles across an entire metro area, you can tell your agent to systematically check every available listing without timing out or getting lost in results.

## How It Works

The bottom line is: it converts natural language requests about jobs into actionable, paginated searches against Indeed's live data.

1. First, subscribe to this MCP and input your Indeed Publisher ID.
2. Next, ask your AI client to run a search by specifying keywords, location details, and any desired filters (like job type).
3. Finally, the agent returns structured data containing detailed job listings that you can use immediately.

## Frequently Asked Questions

**Can I filter by job type like 'full-time' or 'contract'?**
Yes! Use the `search_jobs` tool with the `jt` parameter. You can specify 'fulltime', 'parttime', 'contract', 'internship', or 'temporary' to narrow down your results.

**How do I sort the results to see the newest jobs first?**
Simply set the `sort` parameter to 'date' when calling the `search_jobs` tool. By default, results are sorted by relevance.

**Is it possible to search within a specific radius of a city?**
Yes, you can use the `radius` parameter to define the distance in miles from your target location (provided in the `l` parameter).

**How do I authenticate or set up my account to run `search_jobs`?**
You must subscribe to this MCP and provide your specific Indeed Publisher ID. This setup step authorizes your AI client to access the necessary job data through the tool.

**What happens if I try to search for too many jobs using `search_jobs`?**
The function supports pagination, meaning you control result volume with start and limit parameters. If you exceed these limits in a single call, the tool will return an appropriate error message indicating the required adjustment.

**Can I use `search_jobs` to target roles at specific companies?**
Yes; besides keywords or job titles, you can narrow your search by specifying company names. This helps you quickly find market benchmarks for a particular employer without leaving your workflow.

**How do I get results beyond the initial list when using `search_jobs`?**
You manage result sets using the start and limit parameters. By adjusting these numbers, you can efficiently browse through large volumes of job data page by page.

**Is this MCP suitable for HR professionals needing market intelligence via `search_jobs`?**
Absolutely. Recruiters use this MCP to quickly gather active listings and assess prevailing salary ranges or required skills in specific industries, making it useful for market research.