Recruiter Roles Mcp

pcmarts/recruiter-roles-mcp

Plugs Claude or any MCP client into the Recruiter Roles job board via a read-only API. You get seven tools: search and filter live recruiter jobs by sector, location, salary, and keywords; fetch full job details; browse companies and their open roles; list sectors, locations, and pull market stats like posting velocity and aggregate counts. Ships as a hosted Streamable HTTP endpoint (drop the URL into Cursor or VS Code with your free API key in a header) or run locally via stdio with npx. Built on top of the public Recruiter Roles v1 REST API, so it shares the same 1,000 requests per day rate limit and caching. Requires a visible backlink if you publish the data anywhere.

GitHub stars: 1
tools: 7
auth: Secret needed
transport: STDIO, HTTP
env var: 1
last updated: May 29, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://recruiterroles.com/api/mcp --name recruiter-roles-mcp

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http recruiter-roles-mcp https://recruiterroles.com/api/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 7 tools

Verified live against the running server on Nov 6, 2026.

search_jobsSearch 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.15 params

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.

Parameters* required

citystring

City slug, comma-separated (e.g. 'dallas-tx').

employment_typestring

Employment type filter.one of full_time · part_time · contract · freelance

is_remoteboolean

Shorthand for work_arrangement=remote.

pageinteger

Page number. Default: 1.

per_pageinteger

Results per page. Default: 20, max: 100.

posted_sincestring

ISO date — jobs posted on or after this date.

qstring

Full-text search across job title and company name.

salary_disclosedboolean

true = only jobs with a disclosed salary; false = only undisclosed.

salary_mininteger

Minimum salary in USD. Only returns jobs with a disclosed salary at or above this.

sectorstring

Sector slug, comma-separated for multiple (e.g. 'technology,financial-services'). Use list_sectors for valid slugs.

sortstring

Sort order. Default: recent.one of recent · salary_desc

source_typestring

'direct' = employer-posted, 'scraped' = aggregated.one of direct · scraped

statestring

State/region code, comma-separated (e.g. 'TX,NY,BC'). Use list_locations for codes.

updated_sincestring

ISO datetime — for incremental sync; jobs updated on or after this.

work_arrangementstring

Work arrangement filter.one of on_site · hybrid · remote

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

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

Parameters* required

slug*string

The job slug (the last path segment of its URL, or the 'slug' field from search_jobs).

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

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

Parameters* required

company_typestring

Company type filter.one of staffing_agency · executive_search · boutique_firm · corporate_inhouse · rpo · other

countrystring

HQ country code (e.g. 'US', 'GB').

pageinteger

Page number. Default: 1.

per_pageinteger

Results per page. Default: 20, max: 100.

qstring

Search company name.

sortstring

Sort order. Default: job_count.one of job_count · name · recent

get_companyFetch a single company's full profile plus a paginated list of its active jobs.3 params

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

Parameters* required

pageinteger

Page of the company's jobs. Default: 1.

per_pageinteger

Jobs per page. Default: 20, max: 100.

slug*string

The company slug (e.g. 'robert-half').

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

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

No parameters. Call it with no arguments.

list_locationsList 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.3 params

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.

Parameters* required

countrystring

Filter by country code (e.g. 'US', 'GB').

levelstring

Hierarchy level to return. Default: countries.one of countries · regions · cities

regionstring

Filter cities by region code (e.g. 'TX'). Use with level=cities.

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

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

No parameters. Call it with no arguments.

Configuration

RECRUITER_ROLES_API_KEY*secret

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

Readme

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)
Gemini CLI extension: gemini extensions install https://github.com/pcmarts/recruiter-roles-mcp
Get a free API key: https://recruiterroles.com/api-access
Docs: https://recruiterroles.com/mcp · REST API: https://recruiterroles.com/api-docs

Tools

View the full README on GitHub

Details

Repository: github.com/pcmarts/recruiter-roles-mcp
Website: recruiterroles.com/mcp
Category: Search & Web Crawling
Package: recruiter-roles-mcp
Transport: STDIO, HTTP
Auth: Required
Registry: MCP registry, active
Tools verified: Nov 6, 2026

Related Search & Web Crawling MCP servers

View all

Mcp Gscpijusz/mcp-gscGoogle Search Console MCP server — query performance, sitemaps, indexing & more1stars

Opportunity MCPrevolutionarybukhari/opportunity-mcpSearch youth opportunities (scholarships, fellowships, internships) from any AI assistant.1stars

Slack Mcp Serverstevenvo/slack-mcp-serverRead Slack conversations, threads, user info, and search messages from your MCP client.1stars

qsearchtheyahia/qsearchMulti-engine search for AI agents. Trust scoring, local corpus, MCP-native. Self-hostable, BYOK.1stars

Reftrixmcptkmd/reftrixmcpWeb design analysis with 26 MCP tools: layout, motion, quality, semantic search via pgvector1stars

Aamangeldi Dad Jokes Mcpaamangeldi/dad-jokes-mcpGet a random dad joke or search by keyword to fit any moment. Retrieve specific jokes by ID for re…0stars