# HeyRole

> HeyRole is a free MCP server for hiring and recruiting. Search remote jobs, read postings and get application links, no account needed. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web
- **Website:** https://heyrole.ai/developers
- **MCP Registry name:** ai.heyrole/heyrole
- **Categories:** hiring and recruiting
- **Listing updated:** 2026-11-15

## About

HeyRole's catalogue is read-only, and the site is careful about what remote means: it says remote does not always mean worldwide, location and pay come from the posting's own fields, and missing data stays unknown. You can ask for roles that explicitly list the US or worldwide.

Three tools exist: search_jobs filters active remote roles by location, category, skills and seniority and can require pay information; get_job returns a description, status, source and direct application link; get_filters lists supported filter keys and skills seen in the catalogue. The same data is available over a public REST API with cursor pagination and up to 50 jobs per page.

The limit is about 60 requests a minute per IP, shared across REST and MCP, and results are cached for five minutes. It cannot apply to jobs or access resumes.

## Features

- **Job search:** Filters by location, category, skills, seniority and pay.
- **Posting details:** Description, source and application link.
- **Filter discovery:** Lists filter keys and skills in the catalogue.
- **REST twin:** Same catalogue over a public JSON API.
- **Anonymous access:** No account, key or OAuth.

## Good for

- Find remote backend roles open to the US
- Filter jobs that list pay
- Get application links for a shortlist
- Check location requirements before applying

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http heyrole https://heyrole.ai/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://heyrole.ai/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "heyrole": {
      "url": "https://heyrole.ai/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "heyrole": {
      "type": "http",
      "url": "https://heyrole.ai/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "heyrole": {
      "serverUrl": "https://heyrole.ai/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "heyrole": {
      "type": "http",
      "url": "https://heyrole.ai/mcp"
    }
  }
}
```

## Tools

- `search_jobs`: Search active remote postings using explicit filters. Ordered by first discovery, newest first. Returns compact summaries and an optional cursor; does not assess personal eligibility.
- `get_job`: Read a posting, its current catalog status, description and original application link. Closed/stale jobs may be returned; check status before recommending.
- `get_filters`: Get accepted location, category, seniority and employment keys, plus an alphabetical sample of currently observed skills.

## FAQ

### Do I need an account?

No account, API key or OAuth is needed.

### Can it apply for me?

No. Application links lead to the original hiring site.

### What are the limits?

About 60 requests a minute per IP, shared across REST and MCP.

### Does remote mean worldwide?

No; check each posting's location requirements.

### Is HeyRole free?

Yes. HeyRole is free to use.

### How do I add HeyRole to Claude Code?

Run this command in your terminal: claude mcp add --transport http heyrole https://heyrole.ai/mcp

### What are the best alternatives to HeyRole?

The closest alternatives to HeyRole are Reactive Resume, Nectar Jobs, TeamedUp Intelligence — China & APAC Salary Data, AI Scouts and Spanish Top Tech Companies.

## Alternatives

- [Reactive Resume](https://ai-powered.com/mcp/reactive-resume): Reactive Resume is an open-source MCP server for hiring and recruiting.
- [Nectar Jobs](https://ai-powered.com/mcp/nectar-jobs): Nectar Jobs is a free MCP server for hiring and recruiting.
- [TeamedUp Intelligence — China & APAC Salary Data](https://ai-powered.com/mcp/teamedup-intelligence-china-and-apac-salary-data): TeamedUp Intelligence — China & APAC Salary Data is a freemium MCP server for hiring and recruiting.
- [AI Scouts](https://ai-powered.com/mcp/ai-scouts): AI Scouts is a freemium MCP server for productivity.
- [Spanish Top Tech Companies](https://ai-powered.com/mcp/spanish-top-tech-companies): Spanish Top Tech Companies is a free MCP server for hiring and recruiting.
- [Anshul Panigrahi Portfolio](https://ai-powered.com/mcp/anshul-panigrahi-portfolio): Anshul Panigrahi Portfolio is a free MCP server for hiring and recruiting.
- [WFH Alert Jobs](https://ai-powered.com/mcp/wfh-alert-jobs): WFH Alert Jobs is a free MCP server for hiring and recruiting.
- [Roleford job search](https://ai-powered.com/mcp/roleford-job-search): Roleford job search is a freemium MCP server for hiring and recruiting.

---
Source: https://ai-powered.com/mcp/heyrole
