{
  "markdown": "# Recruiter Roles MCP server\n\nQuery the [Recruiter Roles](https://recruiterroles.com) job board from any\nMCP-capable AI client (Claude, Cursor, ChatGPT, VS Code, …). Ask in plain\nlanguage and get live recruiter and talent-acquisition jobs, company profiles,\nsectors, locations, and market stats — straight from the board.\n\nRead-only. Authenticated with a free Recruiter Roles API key.\n\n- **Hosted (recommended):** `https://recruiterroles.com/api/mcp` (Streamable HTTP)\n- **Local (this package):** `npx recruiter-roles-mcp` (stdio, for stdio-only clients)\n- **Get a free API key:** https://recruiterroles.com/api-access\n- **Docs:** https://recruiterroles.com/mcp · REST API: https://recruiterroles.com/api-docs\n\n## Tools\n\n| Tool | Description |\n| --- | --- |\n| `search_jobs` | Search & filter live jobs (sector, location, salary, remote, recency, full-text). |\n| `get_job` | Full detail for one job — description, requirements, benefits, apply contact. |\n| `list_companies` | Browse recruiting agencies & employers with active job counts. |\n| `get_company` | A company profile plus its active jobs. |\n| `list_sectors` | All recruiting sectors with live job counts. |\n| `list_locations` | Countries, regions, and cities with live job counts. |\n| `market_stats` | Aggregate market overview — totals, posting velocity, and breakdowns. |\n\nAll tools are annotated `readOnlyHint: true`, `destructiveHint: false`,\n`openWorldHint: false`, and expose an `outputSchema`.\n\n## Connect\n\n### Hosted remote server (recommended)\n\nMost clients can connect directly to the hosted Streamable HTTP endpoint with\nyour API key in the `Authorization` header (or as a `?key=` query param for\nclients that can't set headers).\n\n**Cursor** — `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"recruiter-roles\": {\n      \"url\": \"https://recruiterroles.com/api/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer rr_live_YOUR_KEY\" }\n    }\n  }\n}\n```\n\n**VS Code** — `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"recruiter-roles\": {\n      \"type\": \"http\",\n      \"url\": \"https://recruiterroles.com/api/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer rr_live_YOUR_KEY\" }\n    }\n  }\n}\n```\n\n**Claude / ChatGPT custom connector** — add the URL with your key appended:\n\n```\nhttps://recruiterroles.com/api/mcp?key=rr_live_YOUR_KEY\n```\n\n### Local stdio server (this npm package)\n\nFor stdio-only clients or local development. Set your API key via the\n`RECRUITER_ROLES_API_KEY` environment variable:\n\n```json\n{\n  \"mcpServers\": {\n    \"recruiter-roles\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"recruiter-roles-mcp\"],\n      \"env\": { \"RECRUITER_ROLES_API_KEY\": \"rr_live_YOUR_KEY\" }\n    }\n  }\n}\n```\n\nRun it directly:\n\n```bash\nRECRUITER_ROLES_API_KEY=rr_live_YOUR_KEY npx recruiter-roles-mcp\n```\n\n## How it works\n\nThis is a thin, read-only layer over the public Recruiter Roles\n[v1 REST API](https://recruiterroles.com/api-docs). Each tool forwards your API\nkey to one `GET /api/v1/*` endpoint, so MCP usage shares the same rate limit\n(1,000 requests/day per key), caching, and request logging as the REST API. The\nserver holds no database connection and no secrets of its own.\n\n## Develop\n\n```bash\nnpm install\nnpm run build\nRECRUITER_ROLES_API_KEY=rr_live_YOUR_KEY node dist/index.js\n```\n\nOptional: point at a different origin during development with\n`RECRUITER_ROLES_BASE_URL` (default `https://recruiterroles.com`).\n\n## Backlink policy\n\nAny page or product that publishes data obtained through this server must\ninclude a visible, crawlable link back to Recruiter Roles. Keys may be\nsuspended if the backlink is removed.\n\n## License\n\nMIT — see [LICENSE](./LICENSE).\n",
  "bytes": 3634,
  "sha": "f1f9156798ca374d163a406b61d4746c179aa97701f23cf82cd13f6f536181bb",
  "repo_slug": "pcmarts/recruiter-roles-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_pcmarts_recruiter_roles_mcp_e4191793/readme"
}