get_company
Fetch a single company's full profile plus a paginated list of its active jobs.
LABSCO SUMMARY
Posting velocity over 24 hours and 7 days is the number a job board rarely gives you, and it is the one that says whether a market is moving.
A count of open roles is a stock; velocity is a flow, and they tell you different things — a large static board and a small fast-moving one look identical on the headline number. Exposing both is what makes this usable for a decision about timing rather than only about applying. The counts attached to sectors and locations serve the same purpose at a smaller scale: they turn a taxonomy into a signal about where the activity is. Narrow by design — this is the recruiting job market and nothing else — which is what lets the taxonomy be specific enough to be useful.
What it is
A job-board client narrowed to one vertical — recruiter and talent-acquisition roles — with seven tools covering jobs, companies, sectors, locations and aggregate market statistics.
What you get
- search_jobs covers live listings; get_job returns one by slug with the complete detail rather than the search summary.
- list_companies browses the recruiting agencies with their active counts, and get_company returns a full profile plus a paginated list of that agency's open roles.
- list_sectors and list_locations return the taxonomies with active job counts attached, and the location tool covers the hierarchy — countries, regions or cities.
- market_stats returns the aggregate picture including posting velocity over 24 hours and 7 days, which is a different question from how many jobs are open.
Requirements
RECRUITER_ROLES_API_KEY.
Setup effort
One command plus a key — RECRUITER_ROLES_API_KEY=<YOUR_RECRUITER_ROLES_API_KEY> npx recruiter-roles-mcp
USE CASES
01
Finding roles that fit
Search live listings filtered by sector and location, then open the full detail of the ones worth reading properly.
02
Working out who is actually hiring
Browse the agencies with their active counts and open one to see its full roster of live roles.
03
Judging whether the market is moving
Read the posting velocity over 24 hours and 7 days rather than the total open count, which does not distinguish a busy market from a stale one.
7 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
get_job
Fetch the full detail for a single job by its slug, including the complete description, requirements, benefits, tech stack, and apply contact.
list_companies
Browse the directory of recruiting companies and agencies with their active job counts. Filter by name, company type, or HQ country.
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.
list_sectors
List all recruiting sectors with their current active job counts. Use the returned slugs for the 'sector' filter in search_jobs.
market_stats
Aggregate market overview: total active jobs, posting velocity (24h / 7d), and breakdowns by sector, employment type, work arrangement, and country.
search_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.
BEFORE YOU INSTALL
What to know first
Tools you get
7 tools when we connected. All tools are read-only; none posts a job, saves a search or applies. The limit is 1,000 requests per day per key, shared with REST usage.
Requires
RECRUITER_ROLES_API_KEY in your environment
Where it runs
Of the 5 documented clients, 1 runs the server on your machine and 4 connect to a hosted endpoint.
CONTEXT COST
Light Standing cost
Rated by the size of the 7 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
The install command the project publishes
TERMINAL
RECRUITER_ROLES_API_KEY=<YOUR_RECRUITER_ROLES_API_KEY> npx recruiter-roles-mcpHosted endpoint
ENDPOINT URL
https://recruiterroles.com/api/mcpAdd this hosted endpoint to your MCP client using the credentials listed under Requirements.
MCP Clients
Cursor
CURSOR · JSON
{
"mcpServers": {
"recruiter-roles": {
"url": "https://recruiterroles.com/api/mcp",
"headers": {
"Authorization": "Bearer <YOUR_RECRUITER_ROLES_API_KEY>"
}
}
}
}VS Code
VS CODE · JSON
{
"servers": {
"recruiter-roles": {
"type": "http",
"url": "https://recruiterroles.com/api/mcp",
"headers": {
"Authorization": "Bearer <YOUR_RECRUITER_ROLES_API_KEY>"
}
}
}
}Claude Desktop, ChatGPT
URL
https://recruiterroles.com/api/mcp?key=<YOUR_RECRUITER_ROLES_API_KEY>Any MCP client — local stdio
ANY MCP CLIENT — LOCAL STDIO · JSON
{
"mcpServers": {
"recruiter-roles": {
"command": "npx",
"args": [
"-y",
"recruiter-roles-mcp"
],
"env": {
"RECRUITER_ROLES_API_KEY": "<YOUR_RECRUITER_ROLES_API_KEY>"
}
}
}
}
