MCP.Market

Recruiter Roles MCP server

online · 100% uptime
by pcmarts·io.github.pcmarts/recruiter-roles-mcp·v1.0.0·1 stars
No reviews yet

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

A86/100grade A
Write a reviewRun it
What users say
No reviews yet
Be the first
Safety scan
A86/100

full report

Adoption
New

1 stars

Reviews

Write one

Nobody has reviewed Recruiter Roles yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Recruiter Roles tools (7)

write = sends, deletes, buys or posts
  • get_companyFree

    Fetch a single company's full profile plus a paginated list of its active jobs.

  • get_jobFree

    Fetch the full detail for a single job by its slug, including the complete description, requirements, benefits, tech stack, and apply contact.

  • list_companiesFree

    Browse the directory of recruiting companies and agencies with their active job counts. Filter by name, company type, or HQ country.

  • list_locationsFree

    List the location hierarchy (countries, regions, or cities) with active job counts. Use the returned codes/slugs for the 'state' and 'city' filters in search_jobs.

  • list_sectorsFree

    List all recruiting sectors with their current active job counts. Use the returned slugs for the 'sector' filter in search_jobs.

  • market_statsFree

    Aggregate market overview: total active jobs, posting velocity (24h / 7d), and breakdowns by sector, employment type, work arrangement, and country.

  • search_jobsFree

    Search live recruiter and talent-acquisition job listings on Recruiter Roles. Supports full-text search and filtering by sector, location, employment type, work arrangement, salary, and recency. Returns a paginated list with salary, company, location, and a tracked apply URL.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan8 source files scanned25/25
  • Live reliabilityremote reachable in 714ms20/20
  • Tool poisoning7 tool descriptions checked15/15
  • Auth qualityopen endpoint, read-only tools10/15
  • Maintenancelast push 121 days ago8/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 86/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Recruiter Roles compares

Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
86/100
higher than 77% of 3,470 Web search servers
Tools
7
the typical Web search server has 5
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
Uptime
100%
of our recent checks; the typical remote Web search server answers 100%
Response time
181 ms
faster than 72% of 2,238 Web search servers
GitHub stars
1
more than 55% of 1,786 Web search servers

What its tools let an agent do: 6 read · 1 change

Install Recruiter Roles in Claude Code, Cursor or VS Code

claude mcp add --transport http recruiter-roles-mcp https://recruiterroles.com/api/mcp
Add to Cursor

What the publisher says

From the Recruiter Roles repository's README, as published. We do not edit it. Read it on GitHub

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

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 RECRUITERROLESAPI_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 RECRUITERROLESBASE_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.

Nothing above is checked by us. What we check is on the safety report.

Recruiter Roles: common questions

Is Recruiter Roles MCP server safe?
Yes, by our scan: it is graded A (86/100). Read the Recruiter Roles safety report
How do I install Recruiter Roles?
It runs remotely at recruiterroles.com. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
Does Recruiter Roles need an API key?
Yes. The registry entry asks for RECRUITER_ROLES_API_KEY.
Is Recruiter Roles maintained?
The last commit was 159 days ago (2026-05-29). The latest release is v1.0.0.
Is Recruiter Roles up?
100% of our last 28 checks got an answer. We check remote servers about four times a day.
What can I use instead of Recruiter Roles?
Servers from other publishers that do the same job: Workopia — Job Search MCP server, Jobseek MCP server and Exa Search MCP server.
How does Recruiter Roles compare with other Web search MCP servers?
safety score 86/100 (higher than 77% of 3,470 Web search servers); tools 7 (the typical Web search server has 5); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Recruiter Roles

Same job from other publishers: the closest match first, then the best rated.

  • Workopia — Job Search
    Search 6.3M+ live jobs from companies' own career pages, plus resume tailoring & cover letters.
    B
  • Jobseek
    Search jobs and companies on Job Seek (jseek.co)
    A
  • Exa Search
    Search the live web and fetch clean content from source pages.
    A
  • obsei
    Self-hosted customer feedback with PII stripped at ingest: search, stats and themes with citations.
    A
  • Kody
    Your agents' cloud for individuals and teams. Search, execute, packages, jobs, and credentials.
    A