# Roleford job search

> Roleford job search is a freemium MCP server for hiring and recruiting. Run a tech job search from your AI agent: matches, unlocks, applications and follow-ups. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web
- **Website:** https://roleford.com/mcp
- **Repository:** https://github.com/gitranks/roleford-job-search
- **MCP Registry name:** com.roleford/job-search
- **Categories:** hiring and recruiting
- **Listing updated:** 2026-11-14

## About

Roleford does the matching on its own site every morning, using your CV, GitHub and what you are looking for. The MCP server then lets an agent work with that profile: list your matches, dig into a promising one, unlock it, draft the application and log follow-ups. The example prompts include filtering matches that are remote and use Rust, and recording a call with a company and reminding you to follow up.

Controls are built around tokens. Connecting is free, and unlocking a job costs 10 tokens, which reveals the company, the full posting, where to apply and who to write to. At sign-in you choose how many unlocks per day your agents may use in total, 3 by default, and you can disconnect each agent or change the limit under Profile. The server cannot send email from your mailbox, buy tokens or a plan, or delete your account.

Your agent, and the AI company behind it, receive your profile, matched and unlocked jobs, applications and the people suggested for outreach. Set the profile up on roleford.com first, since matches only appear once your skills are known. Free users get 100 tokens on joining and 20 each morning; paid plans and token packs are described as opening soon.

## Features

- **Daily matches:** Finds jobs matched to your profile each morning.
- **Unlock with tokens:** Spends 10 tokens to reveal a posting, apply link and contacts.
- **Application drafting:** Prepares an application written for the chosen job.
- **Follow-up tracking:** Logs calls and keeps applications up to date.
- **Daily unlock cap:** You set how many unlocks all agents may use per day, 3 by default.
- **Clear boundaries:** Cannot send email, buy tokens or delete the account.

## Good for

- Review new remote matches in your preferred language
- Unlock the best fit and prepare an application
- Log a call and set a follow-up reminder
- Keep application status current from your editor
- Limit how many jobs an agent may unlock daily

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http job-search https://mcp.roleford.com/mcp
```

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

```sh
https://mcp.roleford.com/mcp
```

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

```json
{
  "mcpServers": {
    "job-search": {
      "url": "https://mcp.roleford.com/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "job-search": {
      "type": "http",
      "url": "https://mcp.roleford.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "job-search": {
      "serverUrl": "https://mcp.roleford.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "job-search": {
      "type": "http",
      "url": "https://mcp.roleford.com/mcp"
    }
  }
}
```

## FAQ

### Does connecting cost anything?

No. Connecting is free; unlocking a job costs 10 tokens, the same as on the website.

### How do I control my agent?

At sign-in you set a daily unlock limit, and you can disconnect each agent under Profile, Your agents.

### What can it not do?

It cannot send email from your mailbox, buy tokens or a plan, or delete your account.

### What do I need first?

A Roleford profile, built from your CV or GitHub, so matches exist.

### Is Roleford job search free?

Roleford job search has a free plan, with paid plans for more usage or features.

### How do I add Roleford job search to Claude Code?

Run this command in your terminal: claude mcp add --transport http job-search https://mcp.roleford.com/mcp

### What are the best alternatives to Roleford job search?

The closest alternatives to Roleford job search are Reactive Resume, HeyRole, Nectar Jobs, TeamedUp Intelligence — China & APAC Salary Data and AI Scouts.

## Alternatives

- [Reactive Resume](https://ai-powered.com/mcp/reactive-resume): Reactive Resume is an open-source MCP server for hiring and recruiting.
- [HeyRole](https://ai-powered.com/mcp/heyrole): HeyRole is a free 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.

---
Source: https://ai-powered.com/mcp/roleford-job-search
