Skip to content
MCP server

openroles

Pull open roles straight from employers' own applicant tracking systems, no API key

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, Linux, macOS
Runs
Locally
Version
0.5.1
Listing updated
today

Similar MCP servers

About openroles

openroles is an open-source MCP server for hiring and recruiting. It runs locally on your machine and is started by your AI client.

Job boards lag and repost stale listings, so openroles reads the feeds that companies' own careers pages already use. Fifteen systems are supported: Greenhouse, Lever, Ashby, Workday, Workable, Teamtailor, Personio, Recruitee, Rippling, JazzHR, Gem, Polymer, Manatal, Homerun and ClearCompany. A careers site that publishes jobs for search engines also works. Every role comes back in the same shape with the employer's real apply link.

It is a Python library first, with a command line and an MCP server layered on top. The library respects robots.txt, can cache with ETag and Last-Modified so unchanged boards send nothing, and has a helper that lists the hosts a firewall must allow. Postings are checked for text hidden from human readers, which the README notes is sometimes written for a model.

Start the MCP server with openroles mcp. It has two tools, and descriptions are left out unless requested to keep answers short.

Install

Run in a terminal

claude mcp add openroles -- uvx openroles

Add to claude_desktop_config.json

{
  "mcpServers": {
    "openroles": {
      "command": "uvx",
      "args": [
        "openroles"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "openroles": {
      "command": "uvx",
      "args": [
        "openroles"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "openroles": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "openroles"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "openroles": {
      "command": "uvx",
      "args": [
        "openroles"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "openroles": {
      "command": "uvx",
      "args": [
        "openroles"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

find_job_board
Find an employer's job boards and how each was found.
list_open_roles
List open roles, with descriptions only when asked.

What it does

Fifteen ATS sources
Reads Greenhouse, Lever, Ashby, Workday and eleven other systems in one format.
Board detection
Finds an employer's board from a name, careers page, board URL or ats:token.
Search filters
Filter by title words, location, remote only and days since posting.
Polite caching
Honours robots.txt and uses ETag or Last-Modified to skip unchanged boards.
Hidden text report
Flags text in a posting that no human reader would see.
Standard library only
Python 3.9 or newer, no dependencies, no account.

Good for

  • Check every open role at a target company
  • Monitor several employers for new postings in a city
  • Build a job-matching agent that cites the employer's own apply link
  • Work out which hosts a network policy must allow for job feeds

Pricing

Open source

Free open source

openroles FAQ

Does it need an API key?

No. It needs no key or account and uses only the Python standard library.

How do I start the MCP server?

Run openroles mcp, for example claude mcp add openroles -- uvx openroles mcp.

Which tools does the server expose?

find_job_board and list_open_roles.

Does it respect robots.txt?

Yes. fetch raises RobotsDisallowed when the host's robots.txt says no.

Is openroles free?

Yes. openroles is open source, so you can use and self-host it for free.

How do I add openroles to Claude Code?

Run this command in your terminal: claude mcp add openroles -- uvx openroles

What are the best alternatives to openroles?

The closest alternatives to openroles are Scrapling MCP Server, Firecrawl MCP Server, Douyin_TikTok_Download_API, SearXNG Search and Reactive Resume.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers