Skip to content
MCP Server Directory logo
search-knowledge-discovery

Recruiter Roles Mcp

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.

Reviewed overview

MCP server overview

What is Recruiter Roles MCP? Recruiter Roles MCP is an MCP (Model Connector Protocol) server that exposes the live Recruiter Roles job board to MCP-capable AI clients (Claude, Cursor, ChatGPT connectors, VS Code, etc.). It provides read-only access to live recruiter and talent-acquisition jobs, company profiles, sectors, locations, and market statistics via a streamable HTTP endpoint or a local stdio npm package.

How to use the project?

  • Hosted (recommended): connect your client to https://recruiterroles.com/api/mcp and include your API key in the Authorization header or as ?key=rr_live_YOUR_KEY for clients that cannot set headers.
  • Local: run the stdio server with npx recruiter-roles-mcp and set RECRUITER_ROLES_API_KEY=rr_live_YOUR_KEY for stdio-only clients or local development.
  • Developers: the package can be installed and run (npm install, npm run build, node dist/index.js). Docs and REST API are available at recruiterroles.com/mcp and recruiterroles.com/api-docs.

Key features

  • Live job search and filtering (sector, location, salary, remote, recency, full-text)
  • Detailed job endpoint with description, requirements, benefits, and apply contact
  • Company browsing and company profile endpoints with active job listings
  • Lists of sectors and locations with live job counts
  • Market-level aggregate statistics (totals, posting velocity, breakdowns)
  • Read-only, streamable HTTP endpoint and local stdio mode for MCP clients
  • All tools expose output schemas and include readOnlyHint/destructiveHint/openWorldHint annotations
  • Thin proxy over the public REST API (no DB, no secrets stored by the server)

Use cases

  1. Let AI assistants query live recruiter and TA job listings and summarize matches
  2. Integrate job search into developer tools (VS Code, Cursor) via MCP
  3. Research recruiting market trends and get aggregated market stats
  4. Build candidate-sourcing or job-alert workflows that consume live board data
  5. Browse employers and recruiting agencies with active job counts

FAQ

  • Is the API read-only?

Yes. This MCP server is read-only and forwards requests to the public Recruiter Roles v1 REST API.

  • How do I get an API key?

Get a free API key at https://recruiterroles.com/api-access and use it in the Authorization header or as ?key=… for clients that can’t set headers.

  • Are there rate limits?

Yes. MCP usage shares the REST API rate limit: 1,000 requests/day per key.

  • Can I run it locally?

Yes. Use npx recruiter-roles-mcp with RECRUITER_ROLES_API_KEY set, or run the built node server for development.

  • Does the server store my data or keys?

No. The server is a thin proxy and holds no database connection or secrets of its own. It forwards your key to the REST API.

  • Any usage or backlink requirements?

Yes. Pages or products publishing data obtained must include a visible, crawlable backlink to Recruiter Roles; keys may be suspended if the backlink is removed.

  • What is the license?

MIT.