English Français العربية

io.github.pcmarts/recruiter-roles-mcp

Official registry Search and web

Search Recruiter Roles: live recruiter jobs, companies, sectors, locations, and market stats.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http recruiter-roles-mcp 'https://recruiterroles.com/api/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "recruiter-roles-mcp": {
            "type": "http",
            "url": "https://recruiterroles.com/api/mcp"
        }
    }
}
NPM package recruiter-roles-mcp
Claude Code 
claude mcp add recruiter-roles-mcp -e 'RECRUITER_ROLES_API_KEY=<your recruiter_roles_api_key>' -- npx -y recruiter-roles-mcp@1.0.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "recruiter-roles-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "recruiter-roles-mcp@1.0.0"
            ],
            "env": {
                "RECRUITER_ROLES_API_KEY": "<your recruiter_roles_api_key>"
            }
        }
    }
}

Environment variables

  • RECRUITER_ROLES_API_KEY required secret Your Recruiter Roles API key (rr_live_...). Get one free at https://recruiterroles.com/api-access

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Recruiter Roles MCP server
  2. Tools
  3. Connect
  4. How it works
  5. Develop
  6. Backlink policy
  7. License

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.

Tools

ToolDescription
search_jobsSearch & filter live jobs (sector, location, salary, remote, recency, full-text).
get_jobFull detail for one job — description, requirements, benefits, apply contact.
list_companiesBrowse recruiting agencies & employers with active job counts.
get_companyA company profile plus its active jobs.
list_sectorsAll recruiting sectors with live job counts.
list_locationsCountries, regions, and cities with live job counts.
market_statsAggregate market overview — totals, posting velocity, and breakdowns.

All tools are annotated readOnlyHint: true, destructiveHint: false, openWorldHint: false, and expose an outputSchema.

Connect

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).

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.

Frequently asked questions

What is io.github.pcmarts/recruiter-roles-mcp?

Search Recruiter Roles: live recruiter jobs, companies, sectors, locations, and market stats.

How do I install io.github.pcmarts/recruiter-roles-mcp?

It runs as a remote server. In Claude Code: claude mcp add --transport http recruiter-roles-mcp 'https://recruiterroles.com/api/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.pcmarts/recruiter-roles-mcp need an API key?

Yes. It expects RECRUITER_ROLES_API_KEY, which you set in its configuration.

Is io.github.pcmarts/recruiter-roles-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.pcmarts/recruiter-roles-mcp?

It is published by pcmarts. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.