Recruiter Roles — Recruiter & Talent Acquisition Jobs MCP Server
About
MCP server for the Recruiter Roles job board — search live recruiter & talent-acquisition jobs, companies, sectors, locations, and market stats. Read-only, free API key.
Details
- Author
- pcmarts
- GitHub stars
- 1
- Downloads
- 270
- Categories
- Search, AI
Jump to
- Search and filter live recruiter jobs (sector, location, salary, remote).
- Retrieve full job details, requirements, benefits, and apply contact.
- Browse recruiting agencies and employers with active job counts.
- Explore sectors and locations with live job counts.
- Get aggregate market overview with posting velocity and breakdowns.
- Read-only; authenticated with a free API key.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Recruiter Roles — Recruiter & Talent Acquisition Jobs MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Connect via the hosted Streamable HTTP endpoint (https://recruiterroles.com/api/mcp) with an API key in the Authorization header or as a query parameter. For local stdio use, run npx recruiter-roles-mcp and set the RECRUITER_ROLES_API_KEY environment variable. See the README for Cursor, VS Code, and Claude/ChatGPT configuration examples.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"recruiter roles \u2014 recruiter & talent acquisition jobs mcp server": {
"recruiter-roles": {
"url": "https://recruiterroles.com/api/mcp",
"headers": {
"Authorization": "Bearer rr_live_YOUR_KEY"
}
}
}
}
}McpServers
{
"recruiter-roles": {
"url": "https://recruiterroles.com/api/mcp",
"headers": {
"Authorization": "Bearer rr_live_YOUR_KEY"
}
}
}Recruiter Roles MCP server
Query the Recruiter Roles job board from any
MCP-capable AI client (Claude, Cursor, ChatGPT, VS Code, …). Ask in plain
language and get live recruiter and talent-acquisition jobs, company profiles,
sectors, locations, and market stats — straight from the board.
Read-only. Authenticated with a free Recruiter Roles API key.
- Hosted (recommended): https://recruiterroles.com/api/mcp (Streamable HTTP)
- Local (this package): npx recruiter-roles-mcp (stdio, for stdio-only clients)
- Get a free API key: https://recruiterroles.com/api-access
- Docs: https://recruiterroles.com/mcp · REST API: https://recruiterroles.com/api-docs
Tools
| Tool | Description |
| --- | --- |
| search_jobs | Search & filter live jobs (sector, location, salary, remote, recency, full-text). |
| get_job | Full detail for one job — description, requirements, benefits, apply contact. |
| list_companies | Browse recruiting agencies & employers with active job counts. |
| get_company | A company profile plus its active jobs. |
| list_sectors | All recruiting sectors with live job counts. |
| list_locations | Countries, regions, and cities with live job counts. |
| market_stats | Aggregate market overview — totals, posting velocity, and breakdowns. |
All tools are annotated readOnlyHint: true, destructiveHint: false,
openWorldHint: false, and expose an outputSchema.
Connect
Hosted remote server (recommended)
Most clients can connect directly to the hosted Streamable HTTP endpoint with
your API key in the Authorization header (or as a ?key= query param for
clients that can't set headers).
Cursor — ~/.cursor/mcp.json:
{
"mcpServers": {
"recruiter-roles": {
"url": "https://recruiterroles.com/api/mcp",
"headers": { "Authorization": "Bearer rr_live_YOUR_KEY" }
}
}
}
VS Code — .vscode/mcp.json:
{
"servers": {
"recruiter-roles": {
"type": "http",
"url": "https://recruiterroles.com/api/mcp",
"headers": { "Authorization": "Bearer rr_live_YOUR_KEY" }
}
}
}
Claude / ChatGPT custom connector — add the URL with your key appended:
https://recruiterroles.com/api/mcp?key=rr_live_YOUR_KEY
Local stdio server (this npm package)
For stdio-only clients or local development. Set your API key via the
RECRUITER_ROLES_API_KEY environment variable:
{
"mcpServers": {
"recruiter-roles": {
"command": "npx",
"args": ["-y", "recruiter-roles-mcp"],
"env": { "RECRUITER_ROLES_API_KEY": "rr_live_YOUR_KEY" }
}
}
}
Run it directly:
RECRUITER_ROLES_API_KEY=rr_live_YOUR_KEY npx recruiter-roles-mcp
How it works
This is a thin, read-only layer over the public Recruiter Roles
v1 REST API. Each tool forwards your API
key to one GET /api/v1/* endpoint, so MCP usage shares the same rate limit
(1,000 requests/day per key), caching, and request logging as the REST API. The
server holds no database connection and no secrets of its own.
Develop
npm install
npm run build
RECRUITER_ROLES_API_KEY=rr_live_YOUR_KEY node dist/index.js
Optional: point at a different origin during development with
RECRUITER_ROLES_BASE_URL (default https://recruiterroles.com).
Backlink policy
Any page or product that publishes data obtained through this server must
include a visible, crawlable link back to Recruiter Roles. Keys may be
suspended if the backlink is removed.
License
MIT — see LICENSE.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
