English Français العربية

io.github.pcmarts/recruiter-roles-mcp

Registre officiel Recherche et web

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

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http recruiter-roles-mcp 'https://recruiterroles.com/api/mcp'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "recruiter-roles-mcp": {
            "type": "http",
            "url": "https://recruiterroles.com/api/mcp"
        }
    }
}
NPM package recruiter-roles-mcp
Claude Code 
claude mcp add recruiter-roles-mcp -e 'RECRUITER_ROLES_API_KEY=<your recruiter_roles_api_key>' -- npx -y recruiter-roles-mcp@1.0.0
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "recruiter-roles-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "recruiter-roles-mcp@1.0.0"
            ],
            "env": {
                "RECRUITER_ROLES_API_KEY": "<your recruiter_roles_api_key>"
            }
        }
    }
}

Variables d'environnement

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

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Recruiter Roles MCP server
  2. Tools
  3. Connect
  4. How it works
  5. Develop
  6. Backlink policy
  7. License

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.

Tools

ToolDescription
search_jobsSearch & filter live jobs (sector, location, salary, remote, recency, full-text).
get_jobFull detail for one job — description, requirements, benefits, apply contact.
list_companiesBrowse recruiting agencies & employers with active job counts.
get_companyA company profile plus its active jobs.
list_sectorsAll recruiting sectors with live job counts.
list_locationsCountries, regions, and cities with live job counts.
market_statsAggregate market overview — totals, posting velocity, and breakdowns.

All tools are annotated readOnlyHint: true, destructiveHint: false, openWorldHint: false, and expose an outputSchema.

Connect

Most clients can connect directly to the hosted Streamable HTTP endpoint with your API key in the Authorization header (or as a ?key= query param for clients that can't set headers).

Cursor — ~/.cursor/mcp.json:

{
  "mcpServers": {
    "recruiter-roles": {
      "url": "https://recruiterroles.com/api/mcp",
      "headers": { "Authorization": "Bearer rr_live_YOUR_KEY" }
    }
  }
}

VS Code — .vscode/mcp.json:

{
  "servers": {
    "recruiter-roles": {
      "type": "http",
      "url": "https://recruiterroles.com/api/mcp",
      "headers": { "Authorization": "Bearer rr_live_YOUR_KEY" }
    }
  }
}

Claude / ChatGPT custom connector — add the URL with your key appended:

https://recruiterroles.com/api/mcp?key=rr_live_YOUR_KEY
Local stdio server (this npm package)

For stdio-only clients or local development. Set your API key via the RECRUITER_ROLES_API_KEY environment variable:

{
  "mcpServers": {
    "recruiter-roles": {
      "command": "npx",
      "args": ["-y", "recruiter-roles-mcp"],
      "env": { "RECRUITER_ROLES_API_KEY": "rr_live_YOUR_KEY" }
    }
  }
}

Run it directly:

RECRUITER_ROLES_API_KEY=rr_live_YOUR_KEY npx recruiter-roles-mcp

How it works

This is a thin, read-only layer over the public Recruiter Roles v1 REST API. Each tool forwards your API key to one GET /api/v1/* endpoint, so MCP usage shares the same rate limit (1,000 requests/day per key), caching, and request logging as the REST API. The server holds no database connection and no secrets of its own.

Develop

npm install
npm run build
RECRUITER_ROLES_API_KEY=rr_live_YOUR_KEY node dist/index.js

Optional: point at a different origin during development with RECRUITER_ROLES_BASE_URL (default https://recruiterroles.com).

Any page or product that publishes data obtained through this server must include a visible, crawlable link back to Recruiter Roles. Keys may be suspended if the backlink is removed.

License

MIT — see LICENSE.

Questions fréquentes

Qu'est-ce que io.github.pcmarts/recruiter-roles-mcp ?

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

Comment installer io.github.pcmarts/recruiter-roles-mcp ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http recruiter-roles-mcp 'https://recruiterroles.com/api/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.pcmarts/recruiter-roles-mcp ?

Oui. Il attend RECRUITER_ROLES_API_KEY, à renseigner dans sa configuration.

io.github.pcmarts/recruiter-roles-mcp est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.pcmarts/recruiter-roles-mcp ?

Il est publié par pcmarts. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.