General Tools
recruiterroles.com
Provides search and retrieval of recruiter job listings, company profiles, and sector information.
ENDPOINT 1
https://recruiterroles.com/api/mcp
MCP server metadata
- Name
- recruiter-roles
- Version
- 1.0.0
Recruiter Roles serves live recruiter and talent-acquisition job listings (read-only). These tools need a free API key: create one at https://recruiterroles.com/api-access, then connect with ?key=rr_live_... in the URL or an Authorization: Bearer rr_live_... header. Start with search_jobs — filter by sector, location, salary, remote, recency, or full-text q — then call get_job with a slug for the full description and apply details. The sector and location filters need exact slugs/codes: fetch them from list_sectors and list_locations first. Use list_companies/get_company for agencies and market_stats for aggregate trends. All tools share one API key and a 1,000 requests/day limit, so prefer narrow filters and reasonable per_page values over broad scans. A job's `url` field is a tracked link — prefer it when linking out.
Known tools 7
search_jobsSearch live recruiter and talent-acquisition job listings on Recruiter Roles.
Inferred read-onlyget_jobFetch the full detail for a single job by its slug, including the complete description, requirements, benefits, tech stack, and apply contact.
Inferred read-onlylist_companiesBrowse the directory of recruiting companies and agencies with their active job counts.
Inferred read-onlyget_companyFetch a single company's full profile plus a paginated list of its active jobs.
Inferred read-onlylist_locationsList the location hierarchy (countries, regions, or cities) with active job counts.
Inferred read-onlymarket_statsAggregate market overview: total active jobs, posting velocity (24h / 7d), and breakdowns by sector, employment type, work arrangement, and country.
Inferred read-onlyCONNECT WITH APPROVAL
Client installation
Review this server and its permissions before adding it. Secret placeholders must be set locally.
Codex
~/.codex/config.toml
[mcp_servers.recruiter-roles]
url = "https://recruiterroles.com/api/mcp"
enabled = true
Claude Code
.mcp.json
{
"mcpServers": {
"recruiter-roles": {
"type": "http",
"url": "https://recruiterroles.com/api/mcp"
}
}
}
Claude Desktop
Settings → Connectors → Add custom connector
Name: recruiter-roles
Remote MCP URL: https://recruiterroles.com/api/mcp
Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.
Cursor
.cursor/mcp.json
{
"mcpServers": {
"recruiter-roles": {
"url": "https://recruiterroles.com/api/mcp"
}
}
}
Visual Studio Code
.vscode/mcp.json
Add to Visual Studio Code{
"servers": {
"recruiter-roles": {
"type": "http",
"url": "https://recruiterroles.com/api/mcp"
}
}
}
Generic MCP
Client-specific MCP configuration
{
"name": "recruiter-roles",
"transport": "streamable-http",
"url": "https://recruiterroles.com/api/mcp"
}
MCP Inspector
Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.
TRUST AND VERIFICATION EVIDENCE
Loading Trust v2 evidence…
Checking the associated registrable domain. The BuiltWith key remains server-side.
Evidence is source-attributed and does not guarantee that a third-party server is safe. Risk labels are conservative metadata heuristics.