# recruiter-roles-mcp MCP server

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

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-pcmarts-recruiter-roles-mcp
- Repository: https://github.com/pcmarts/recruiter-roles-mcp
- Website: https://recruiterroles.com/mcp

## Install
- Command: `npx -y recruiter-roles-mcp`
- Endpoint: https://recruiterroles.com/api/mcp
- Auth: Auth required by registry metadata

## Setup notes
- Package: Npm recruiter-roles-mcp v1.0.0
- Environment variable: RECRUITER_ROLES_API_KEY (required; secret)
- The upstream registry signals required auth or secrets.
- Remote endpoint: https://recruiterroles.com/api/mcp

## Tools
- search_jobs (Search recruiter jobs) - 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. Endpoint: https://recruiterroles.com/api/mcp
- get_job (Get job detail) - Fetch the full detail for a single job by its slug, including the complete description, requirements, benefits, tech stack, and apply contact. Endpoint: https://recruiterroles.com/api/mcp
- list_companies (List recruiting companies) - Browse the directory of recruiting companies and agencies with their active job counts. Filter by name, company type, or HQ country. Endpoint: https://recruiterroles.com/api/mcp
- get_company (Get company profile) - Fetch a single company's full profile plus a paginated list of its active jobs. Endpoint: https://recruiterroles.com/api/mcp
- list_sectors (List sectors) - List all recruiting sectors with their current active job counts. Use the returned slugs for the 'sector' filter in search_jobs. Endpoint: https://recruiterroles.com/api/mcp
- list_locations (List locations) - 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. Endpoint: https://recruiterroles.com/api/mcp
- market_stats (Recruiter job market stats) - Aggregate market overview: total active jobs, posting velocity (24h / 7d), and breakdowns by sector, employment type, work arrangement, and country. Endpoint: https://recruiterroles.com/api/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.github.pcmarts
- Version: 1.0.0
- Runtime: Npm
- Transports: STDIO, HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: May 29, 2026
- Source: https://registry.modelcontextprotocol.io